The IM Underground Volume *1 
Introduction 

The Geneva- 12, Geneva-9, Athens- 18, and Monaco-9 fonts are needed to 
correctly view and print the files on this disk. The applications MacPaint, 
MacWrite, and Consulair's Edit are needed to fully view and print the files. 
MacWrite could be substituted for Edit as long as the ruler is set up to 
emulate 8 character tab settings and a font such as Monaco-9 is used. 

The disk contains the following files; 

Schematics 

Memory (MacPaint) 
Control Logic (MacPaint) 
CPU & ROM (MacPaint) 
IWM&Vi A (MacPaint) 
Serial Interface (MacPaint) 
Address Multiplexer (MacPaint) 
Keyboard &, Mouse (MacPaint) 
128K/512K (MacPaint) 

Hardware info 

Keyboard Hardware (MacWrite) 
Video Hardware (MacWrite) 
Sound Hardware (MacWrite) 
VIA Hardware (MacWrite) 
Mouse Hardware (MacWrite) 

Keu board ROM 

802 1PA6E0 (Edit) 
8021 PAGE 1 (Edit) 
802 1PAGE2 (Edit) 
802 1PA6E3 (Edit) 
Register Usage (Edit) 
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Video Timing (MacPaint) 
Hacker Chart (Mac Write) 
Empty Folder (Yes ~ it is empty!) 

Su stem info 

The System Revealed (MacV/rite) 
The Small System (MacWrite) 
Resource Flags (MacWrite) 
512K Upgrade (MacWrite) 
Beyond 5 12K (MacWrite) 

We strongly suggest that the reader also obtain (if they don't already 
have it) the software documentation insfde tiacfrftoshU^sxxx Apple as it 
provides valuable information about the inner workings of the operating 
system and device drivers. 

Please notify us of any errors and/or omissions so that future releases 
can be corrected. 



The keyboard ROM listings in from an 8021 MPU that did not have Apple's copyright in or on it. 
The circuit board schematics ^r^ traced from several Macintosh logic boards. 

Apple, Apple Care, Finder, lmage¥riter. Inside Macintosh, Lisa, Mac, Macintosh, Macintosh XL, 

MacPaint, MacsBug, MacWorks, MacVrite, QuickDraw, Resource Editor, and Resource Mover 
are trademarks of Apple Computer, Inc. 

Consulair is a trademark of Consulair, Inc. 

Intel is a trademark of Intel Corporation. 

Fedit is copyright by John Mitchell. 

Motorola is a trademark of Motorola , Inc . 

Rockwell is a trademark of Rockwell international. 

Synertek is a trademark of Synertek, Inc. 

Zilog is a trademark of Zilog, Inc. 

The IM Underground Volume *1 is available for $25 from: 
The IM Underground 
71 5 Church .Street *16 
Ann Arbor, Michigan 48104 
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Keyboard Hard?rare 

This document covers the Macintosh keyboard and it's communications 
protocol. Electrically, the keyboard appears as a two dimensional array of 
open/closed switches that can be scanned by sending a signal out one set of 
wires and then checking a second set for the signal to return. If a key is 
depressed, it will connect the two wires attached to it thus causing a signal 
sent out one of the wires to be returned via the other, in the Macintosh/the 
actual arrangement consists of a 6 by 9 array where the 9 VYire set is' used 
to output a signal and the 6 wire set is used to detect this same signal. 
This array provides locations for up to 54 keys of which 52 are used in the 
US version (53 on international versions.). 

Such an arrangement has one intrinsic problem - when more than two 
keys are depressed, it is possible for "ghost" keys to appear. For example, 
when three keys in an L shaped pattern are depressed, s fourth key will 
"appear" at the last vertice of a square containing these four keys. 
Therefore, certain keys that are used in conjunction with others may not be 
in this array. The Shift, Option, Caps Lock, and Command are thus connected 
directly to the keyboard controller. Programatically, they can be thought of 
as being in the same array as the rest of the keyboard even though they are 
physically separate. 

The keyboard is controlled (and scanned) by an Intel 8021 single chip 
microcomputer. This device contains 1024 bytes of program ROM and 
appro>^imstely 65 bytes of internal RAM. It can e^-^ecute up to 100,000 
operations per second. Electrical power is supplied via two of the four 
wires in the keyboard cable. The other two wires are used to communicate 
in serial with the Macintosh. An almost identical arrangement can be found 
in Apple's numeric keypad. The biggest difference is that the keyboard array 
size has been changed. 

The keyboard serial interface operates in an isosynchronous mode where 
a clock signal is supplied on one wire while data is sent (or received) over 
the other. The reason for the separate clock is that the keyboard does not 
contain a precise frequency source. 

The format of the data sent is the same as a 7 bit asynchronous link that 
has one start bit and a one stop bit. The only difference is that the high 
order data bit is sent first. When the Macintosh wishes to send to the 
keyboard, it sets it's serial output to a logic and then loads a register 
with the data to send. Eventually, the keyboard will notice the start bit and 
respond by supplying the clock signal to clock the data byte to it one bit at a 
time. Should the keyboard wish to send to the Macintosh, it simply places 
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it's data on the serial data line and generates the clock which allows the 
Macintosh hardware to receive the data. Note that the keyboard always 
generates a clock for either data transfer direction. Also, data can be sent 
in both directions on the same wire. (The data rate used in this interface is 
near 3300 bits per second.) 

The software in the keyboard operates by scanning all of the keys 
repeatedly until a change is detected. This key is then "debounced" and the 
Macintosh told about the change. In greater detail: The software starts at 
the beginning of the key array and compares the present key status 
(pushed/not pushed) of each key with what it saw previously. When a change 
is detected, the software waits several milliseconds and then checks if the 
key is still at it's new state. If so, a code byte for this change is 
constructed and placed in a short buffer. Eventually, the keyboard will be 
able to send this code to the Macintosh. Once per keyboard checking loop, 
the keyboard checks the serial data line for a start bit. If there is one, it 
tries to receive the data. Also, the keyboard will be checking it's buffer for 
any data to send that it is allowed to send, if there is some, it will be sent. 

The communications format used by the keyboard, keypad, and Macintosh 
between themselves is a loose daisy-chained master/slave type of 
architecture. For a slave to send data, it must have permission to send 
given to it by the master. Since the interface is a bidirectional system 
without collision detection, the rules for its operation need to be closely 
followed. There are several cases where they may be broken due to a 
time-out. These are listed below. The system is configured such that the 
Macintosh is always a master and the keyboard is always a slave. Any 
keypads (there could be more than one - although the Mac could get 
confused) in between act as a slave to the Macintosh (or next higher 
element) and as a master to the keyboard (or next lower element). 

There are 5 different commands that may be sent by the master. Of 
these, the Permission to send and Self test keyboard commands (hex 10 and 
76) are only sent by the Macintosh itself. If a slave receives any commands 
other than these, the slave ignores them. The commands are; 

Request to send (Hex code 1 4 ) 

This code is sent when the master wants data. The slave has permission 
to respond with one byte of data svhich it should do immediately. If it has 
no real data, a hex 7B should be sent. 
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Permission to send (Hex code 10 ) 

This code is sent by the master to give the sieve permission to send one 
byte of data when it is generated. After this one byte is sent, (it need not 
be immediately) permission will once again be with the master. 

Reset and identif y ( Hex code 16 ) 

This code is sent by the master to reset the slave and have it identify 
itself. The slave has permission to respond with one of the following 3 
codes. Hex 02 if it is just a keyboard, hex 10 if it is just a keypad, and hex 
12 if both a keypad and a keyboard are present. (The result of this command 
can be found in the system global KbdType at memory location $21E in the 
Macintosh.) 

Perform self test (Hex code 56 ) 

This code is sent by the master to have the slave perform a test of its 
RAM. The slave has permission to send a single byte result code. Hex 77 is 
sent if there was an error and a hex 7D is sent if the RAM tested out OK. 

Remote self test (Hex code 76 ) 

This code is only sent by the Macintosh when both a keypad and keyboard 
are present. The keypad will pass a self test command to the keyboard and 
then pass the result to the Mac. If no keyboard is present or if it does not 
respond, the keypad will send back a hex 77 as an error code. As normal, 
permission will revert to the Macintosh (the master) after this result is 
sent, in reality any byte with bit D5 set will be passed through with this 
same bit cleared. 

If the slave does not respond in a short time period to a command 
requesting immediate response, permission to send will revert back to the 
master. This is so that if a device is not present, the master will not get 
stuck in a loop waiting for the (non-existent) slave. This also allows the 
slaves to be disconnected/connected at any time svithout destroying the 
interface integrity. The Macintosh normally operates any slaves below it in 
the Permission to send mode. Thus the slaves have a timeout mode where 
they send a hex 7B to say that they have no data if no activity takes place 
for about a quarter second. The keyboard will load its FIFO v/ith a 7B after 
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the timeout but will not send the byte unless it has permission to send. 
Thus, if it is operated in Request for data mode only, these requests should 
be at a reasonably fast rate, if the keypad times out, it will send a byte of 
data even if does not have permission. Thus it should be polled with request 
for data at a reasonable rate or the master should assume that it does not 
have permission to send. V/hen a keypad is in the system, it will operate the 
slave under it in a request for data mode. This polling occurs at a 
reasonable rate. The data sent to the keypad is stored in a FIFO so that it 
can later be sent upon request to the Macintosh. 



Data sent b y a slave 

1 - 66 Codes for keys as they are pushed down. 

81 - EB Codes for keys as they are released. 

6D/ED Unused by keyboard/keypad. 

6F/EF CTRL push/release. 

71/F1 SHIFT push/release. 

7.3/F3 CAPS LOCK push/' release. 

75/F5 OPTION push/release. 

77 Error from memory test. 

79 Prefix to flag foil owing key code as a 

keypad key. 

7B No change in status. 

7D Memory test passed. 

7F/FF Unused by keyboard/keypad. 

F7-FD Unused by keyboard/keypad. 



Commands sent b y a master 

10 Permission to send. 

14 Request to send data. 

16 Reset and identify all devices. 

3d Perform self test in first receiving device. 

76 Pass a self test command to the ney.i device. 
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Video Hardware 

A roster-scon video display (such os the one in the Mocintosh) operotes 
by scanning a beam of electrons across the screen (CRT), norn^ially from left 
to right and top to bottom. The beam is modulated by the video signal - thus 
selectively activating the phosphor in the tube and causing it to emit light. 
Scanning must be repeated at approximately 50 Hertz since the phosphor 
quickly stops emitting light. This article describes how the modulating 
signal is made and the side affects that are produced. 

Since the electron beam scans each dot (pixel) on the screen individually, 
the information to control it must be sent one unit at a time, in the 
Macintosh, each pixel can be either black or white, so one binary bit of 
information is sufficient for each pixel. As the electron beam scans, it 
needs a continuous supply of bits (one at a time). This bit stream is 
produced on the digital logic board by the video display hardware. This 
hardware also produces two other signals - one to tell the electron beam 
when to return to the left edge of the screen and one to tell it when to 
return to the top. While the electron beam does this. It is kept turned off to 
prevent white lines on the screen in it's path. (!n a black and white monitor, 
there really aren't individual dots on the screen - rather, the shape of the 
modulating signal delineates the boundaries between pixels. The entire 
process is similar to dragging a pen across a piece of paper and selectively 
lifting and dropping it.) 

To continually scan the display, the present image on the screen is kept 
in memory (RAM) and read out by the video hardware as it is needed. The 
Macintosh memory is 16 bits wide - thus this many bits are read at a time. 
A device called a shift register is used to convert the 16 bits into a bit 
stream that is 16 units of time long - thus defining 16 pixels on the CRT. 
incidentally, reading the video display performs another vital function - 
"refreshing' the memory. This is needed because dynamic memory (as used in 
the Macintosh) consists of many small, leaky capacitors. These must be 
continuously discharged or recharged to retain their data. A read (or write) 
operation on the memory is enough to refresh 128 (or 256) memory 
locations. 

Any description of the video timing must also include the memory timing 
since the hardware for these is strongly intertwined. Proceeding with this 
- the memory cycles 1958400 times per second. Each cycle is therefore 
about about 511 nanoseconds (nS) long. These cycles are divided evenly 
between the CPU and video with each device using alternate cycles. V/hile 
video refresh is active (i.e., not in a retrace) it's cycles are used to fetch 
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video data for the CRT. Since these words are read every 1.021 
microseconds (uS), just enough bits will be fetched to meet the needs of the 
15.6672 MHz video shift rate. At the end of every horizontal retrace, the 
video cycle is used instead to read the sound and disk speed information 
from their RAM buffers. The remaining video cycles are given to the CPU to 
allow the system to run faster. This can be done because the electron beam 
is in retrace and needs no video signal. (See the MacPaint document "Video 
Timing') 

The figure has been arranged such that it contains all the memory cycles 
that happen during one complete screen refresh (frame). Including the 
retrace times, there are a total of S&'*370 or 32560 memory cycles in one 
frame. This results in a screen refresh rate of 1958400/32560 or 60.147 
Hz. As can be seen from the figure, each of the first 342 scan lines of the 
CRT contain 32 video accesses and 32 CPU accesses in the active part, and 
23 CPU accesses and I sound/disk-speed access in the inactive (retrace) 
part. Also, the last 26 scan lines (which occur during vertical retrace) 
contain 67 CPU accesses and 1 sound/disk-speed access. 

One important result of the above is that the 68000 CPU cannot run at 
it's full 7.8336 MHz speed from the RAM since at that rate, it could use all 
1958400 memory cycles in each second. !f the CPU requests access to the 
RAM while it is being used by the video hardware, it will be forced to wait 
for it's turn. However, internally, the CPU can still run at it's full speed. 
This can be used to advantage by assembly language programmers by careful 
arrangement of operations. For example, suppose the contents of all 8 data 
registers (D0-D7) need to be multiplied by some constant and then a 
different constant needs to be added to the results. One immediately 
obvious way of doing this is to have 8 MULU (or MULS) operations in a row 
and then 8 ADD opcodes in a row. This arrangement is the not the fastest 
possible - the ADD operations will be limited by the speed that these 
opcodes can be fetched by the 68000. A better method would be to alternate 
the MULU and ADD opcodes. This way, the ADD opcode will be read into the 
68000"s instruction queue while the preceding multiply is taking place. The 
result is that the 66000 runs at it's full speed internally. 

The memory used by the Macintosh for it's video display normally starts 
at $01A700 ($07A700 in 512K versions). However, knowledge of this 
address is not needed to program the Macintosh since QuickDraw will 
automatically set up it's data structures to use the correct range of 
memory. The hardware itself supports the use of a different range (page) of 
memory as an alternate source of video data - this video page begins exactly 
bytes below the first. Since the hardware can instantly switch 
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between the two pages, they couid be used in extremely fast graphics 
applications. (None of the 'standard' application programs out yet use the 
second video page - mainly because it leaves very little memory ieft for the 
program on a 128K machine.) 

There is almost no support in the operating system to allow use of the 
second video page. It is limited to the 'Launch' and 'Chain' operating system 
calls. Both of these allow a selector code to determine which video page 
will be used by the application. However, this only allocates an extra 32K 
of memory after the stack memory if the second video page is selected. It 
does nothing to switch the actual memory used by the hardware. 
Furthermore, when a program is run from the Finder, it will be run with the 
first video page selected - the only way to actually run a program with the 
second video page selected is to write a short program that calls the main 
program with the correct page setup. Finally, the 'Launch' and 'Chain" 
routines do not insure that the second video page is actually usable - a 
debugging program such as MacsBug may occupy that memory. 

The best way use the second video page is to launch the program 
normally. Then check if the present system is a Macintosh (i.e., not a Lisa 
running MacWorks) by checking such things as the screen size and operating 
system version numbers stored in global RAM memory variables and exiting 
if they are incorrect. The presence of MacsBug (or a RAMdisk) can be 
detected by checking if the system global s BufPtr (at $OIOC) and ScrnBase 
(at $0624) are the same. After this, the program can set up to use the 
second video page in one of two ways. If the memory space between the two 
pages (10880 bytes) is not enough for the stack space needs of the program, 
it can manually set the stack top just below the start of the second video 
page. Otherwise, the stack can be left where it is and the memory space for 
the second page reserved. Setting the application heap limit to a point just- 
below that memory would suffice to reserve it - however, this does not 
prevent the CPU stack from growing down into the video display. A better 
way would be to manually (i.e., not via the operating system) make the 
second video page a non-relocatable memory block at the very end of the 
application heap. This syIII allow the stack-overflow sniffer to operate 
normally and detect any stack overflows. 
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Sound Hardware 

Overall, the sound generator can be broken dov'/n Into four pieces of 
vv'hjch three are hardware. These four pieces can then be arranged in a 
hierarchy through which "commands" Uow. At the highest level is a program 
that controls all the 'mr&ware below it. This is part of the riacintosh 
Operating System and thus not a subject of this document. The level just 
below this is an arbitrary waveform generator. This can be thought of as a 
black box that converts input data into any output desired. If the output of 
this box v/ere graphed on the y-axis of a graph v-/hile the x-axis was time, 
the data supplied to the box would be all the y coordinates needed to produce 
the desired output. However, because this could require an infinite amount 
of data to produce certain sounds, certain limitations are imposed by the 
hardware. The main one is that the y values are only supplied at discrete 
(not continuous) time intervals. A smaller limitation is that the y values 
can have only a limited amount of precision. When this data is provided to 
the "black box", the intervals betv-/een the points are filled by interpolation. 
The output of the black box is then sent to the third part of this hierarchy 
which is an audio amplifier. The amplification (or resulting output volume) 
that this section provides can be controlled by software. The final element 
of this hierarchy is the speaker or external stereo system connected to the 
audio output jack of the Macintosh. 

The arbitrary waveform generator is essentially a Digital to Analog 
Converter (DAC). In operation, the data that is sent to this" DAC is held in 
memory (RAM) in a buffer - so that it can be generated before the hardV'^are 
actually needs it. As data is needed, the DAC is given the contents of 
successive locations of this buffer. This buffer holds enough data to 
generate 1/60th of a second of sound. 

The DAC itself is built in a somewhat unconventional vv'ay. The sound 
data coming from the buffer is first converted into variable v-/idth pulses by 
a counter circuit. These pulses are then approximately integrated over time 
by an analog circuit. The output of this is a voltage that roughly relates to 
the pulse width (which v^as originally controlled by the data from the 
buffer). The pulse width can be from to 255 units of time. A width of 255 
will result in a positive peak to the speaker v^hile a pulse v^idth of makes 
a negative peak. 

As the system is running, data values are taken (by hardware) from the 
buffer at the end of every horizontal retrace of the video monitor. This is a 
rate of 1 5.6672/704 flHz or about 22254.5 Hz. This data is then loaded into 
an 8 bit "up" counter. During the next horizontal scan line, this counter mU 
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the next section of sound. The main or default buffer used most often is 
called the First Sound Page while the second buffer is called (naturally) the 
Second Sound Page. Each buffer contains 1/60th of a second of sound or 370 
samples. The buffer used is determined by an output bit that is controllable 
by the program making the sound, in a 128K Macintosh, the first sound page 
starts at $1FD00 or 130304 decimal while the second page starts at an 
address of $1A100 or 106752 decimal. After this starting address, the 
sound data occupies the even numibered memory locations. The odd locations 
are used to control the disk speed and thus should never be modified in the 
process of producing sound. The last address used in the first sound page is 
$1FFE2 or 131042 decimal while the last used address in the second page is 
$1A3E2or 107490 decimal. 

The above method for producing sound output is very good at producing 
high quality sounds but it also will take a large amount of computer power 
to generate the 22255 samples needed every second to produce sound. 
Although it is possible to generate !/60th second of sound and then allow 
this data to repeat continually, doing this will limit the sound output to 
those frequencies that can be evenly divided into 1/60 second intervals. 
Therefore, there are two other ways to produce sound that are less 
demanding on the microprocessor. Both of these involve a special control 
line to the 8 bit up counter used to produce the varying pulse widths. Both 
methods mU also result in square svave output. A square wave signal is not 
a "pure" sound but rather it is the sum of a large number of sine waves 
which each are mathematically a pure sound. While the control line to the 
counter is active, it will force the counter to a value of 0. This will result 
in a pulse width output of indefinite length for as long as the control line is 
active. If the sound buffer is entirely filled with the value of 255 and the 
control is turned on and off, sound will be produced. This is because the 
pulse width will essentially be changed from 0^ to 100% depending upon the 
control line. 

This control line can be changed in two ways. The simplest is for the 
microprocessor to change it as needed to produce the desired sound. 
Another way is to program one of the large scale integration chips in the 
Macintosh to produce a square wave frequency there. Thus the frequency of 
a sound can be controlled with minimal processor control. An interestinq 
effect can also be performed with this circuitry. Instead of loading the 
sound buffer with all 255s, a real sound can be stored there. The square 
wave being driven into the counter will then toggle the sound on and off. 
This essentially adds a second sound signal to the output. Since the only 
way to terminate a pulse from the counter is for it to count up to 255, there 
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will be a delay of about 32 microseconds as the counter does this counting. 
Normally though, this will be of no affect. The control line also has a 
second use; when set up to be controlled directly by the CPU, it Is used to 
turn the sound on and off. Thus between sounds, all audio output can be shut 
off. 

Several precautions should be observed when designing sound output. The 
first of these is the limited frequency range of the audio output circuitry. 
At low frequencies, the gain of the amplifier is reduced. This should not be 
a big problem since most of these low frequencies won't be heard. However, 
for frequencies that approach the low end of the range, some erdrQ 
amplitude must be given to account for the loss in the amplifier. At the 
high end of the spectrum, more problems can result. Since each audio cycle 
of output will need at least two samples to produce the frequency, the 
highest possible frequency that can be produced is 1 11 27 Hz. Also, since 
the filter circuit converting the pulse s-^/idth signal will be filterinq high 
frequencies, a loss of amplitude will occur. This loss will be large enough 
so that it can not be made up vnth a larger magnitude of values stored in the 
sound buffer. Another precaution to observe Is to use the control line to 
turn the sound off instead of just filling the sound buffer with a constant 
value (The buffer could be filled with 255's with no ill affect though). This 
is due to the fact that while the counter is producing any sort of pulse 
output, the filter will allow some of it to appear at the speaker output in 
the form of a very quite high pitched noise. The internal speaker will not 
reproduce this well, but a home stereo system attached via the audio output 
jack might. Another precaution is that when the control line to the counter 
Is active, the effective output pulse width Is 352 units. Since the range of 
outputs for the counter (when it Is being fed data from the sound buffer) is 
only from to 255 units, activating the control line will [In all cases] cause 
a large sudden change in the audio output signal. This will sound like a click 
or pop and Is the reason that certain sounds start and end sharply. There is 
no solution to this problem, however, having sounds end at a pulse width of 
255 (by filling the sound buffer with 0"s) will reduce the magnitude of the 
change to the smallest possible value. 

The three volume control bits each have approximately a binary weight. 
In other words, as the value represented by these bits is Increased in a 
binary manner, the volume will Increase in approximately equal steps. 
However, this pattern is not e;^act - writing the control bits most 
significant to least significant and assigning the 000 setting to have the 
relative volume level of 1, the following relationship holds: 000 = 1.0 , 001 
= 2.0,010=4.1 ,011 =5.1 , 100 = 7.9" 101 =8.9, 110= 11.0, 111 ='l2.0 
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Thus the volume setting of 7 is twelve times louder than the setting of 0. 
Note that a control panel setting of results in the sound being turned off 
in some programs svhile other programs will use it as just another volume 
setting. 

All the control signals for the sound hardware come from a 5522 
Versatile Interface Adapter chip. This component is itself as complicated 
as the sound circuitry so only a minimal amount of information about it will 
be presented hers. For programming purposes, it can be treated as a set of 
sixteen memory addresses of which two are of interest for this column. At 
the memory address of 1 1 10-1kxk-xkk]-1 t 1x-kkxx-kj^kO, DO through D2 of 
the byte are the sound volume control bits. D2 is the most significant bit, 
D1 the next, and DO the least significant bit. In the above address, the x's 
represent bits that can be either or 1 (Apple seems to prefer to set these 
to I's.) Thus the address is lEFFFFE or 15728638 decimal. Since the other 
bits in this byte are used for other system uses, the present value should be 
read, modified, and then written back (preferably with interrupts turned 
off). In BASIC to set the volume to 5, this would be: IRA = 15728636! : POKE 
IRA,PEEK(1RA) AND 5.HF8 OR &H05. Note: this does not change the control 
panel (master) volume setting. 

At the same location that the volume can be modified, 04 selects which 
sound page will be used. Setting this bit to a 1 will select the first sound 
page. Putting a Into this bit will select the second sound page. This bit 
should probably never be modified since the disk speed control data also 
comes from this same page. When this bit is changed from BASIC, the 
operating system will still be using the first sound page and if any disk 
usage is needed, the system will "hang". 

At the address of 1 HO-Ikxx-xxxO-OOOx-xxxx-kxxO (SEFEIFE or 
15720956), the control line to the counter is found. A 1 will allow the 
counter to operate and thus produce sound v/hile a will force the counter 
to the state. This bit is found in 07 and can be read/written just like the 
volume control bits. Several other locations in the 6522 chip can be used to 
command this bit to be connected to the output of a counter. This is how a 
square wave audio output can be generated. 
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VIA Hardware 

This docuiTient describes all the inouts and outouts avaiiaDie inrougn tne 
Macintosh's 5522 Versatile interface Adapter (VIA) chip. Since this 1s a 
rather complicated chip, the various other functions It performs Internally 
will not be described. (For further Information on this chip's Internal 
operations, consult the Synertek or Rockwell manual about it.) 

The entire chip consists of 16 different byte wide registers through 
which all of it's operations can be controlled. Secause of the way that. It 1s 
attached, each of the 16 registers is located 512 bytes apart in the 
Macintosh memory map. To find the e^act address of each register, the 
register number should be multiplied by 512 and a base address added to 
this result. The final result is the memory address to use. Normally the 
offset (register number * 512) is fixed so that it can be coded directly into 
a program. The base address is also fixed (In the Macintosh). 

Assembly language programmers can use the global variable "VIA" at 
memory location $1D4 to find the base address of the VIA. The code to do 
this is actually 2 bytes shorter than loading the base address as an 
unmediate value (using the global variable takes one to two microseconds 
longer though). This global variable normally contains the value $EFEIFE. 
Once the base address Is In a register, the address register v-zith 
displacement mode can be used to get to the desired register in the VIA. 

Register number 15 (offset of SlEOO and address of SEFFFFE) Is used to 
access the Input and output bits located in Port A (PAn). A read operation 
vv'ill return the current value on the chip's pins. A write operation V'/ill only 
affect the current output bits. Olts that are Inputs will still latch the value 
written, however it won't appear as an output until the line Is changed to be 
an output. Register number (offset of and address of SEFEIFE) is used to 
access those bits found on Port B. Most of the 14 remaining registers are 
not needed v^hile doing simple operations with the VIA. 

SVO, SVI, and SV2 control the sound volume. A binary value of 000 
produces the lov/est volume v-zhlle a binary value of in produces the 
maKimum volume. Normally these bits will be altered only by the operating 
system. (It will set them to match the volumie selected from the control 
panel.) However, as there is no routine to change the volume, a program 
would need to alter these bits directly should It need to change the current 
volume setting. Apple recommends that this be done with the 68000's 
interrupt priority level set to ".3" so that an interrupt cannot occur while 
the bits are being changed. 

When OVERLAY is a 1, ROM memory Is available at memiory address 0. 
This Is used during system reset to allow the 68000 to read a reset vector 
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line. At present, this input is not used by the operating system. A possible 
use is to perform flicker free video page switching at a certain point In the 
video refresh. Another use is as a time base upon which some input 
sampling could be performed. Since it Is of exactly the same frequency as 
the sound output sampling rate, it might be used to help digitize an input 
sound into the same number of samples needed to output it at a later time. 

The SOUNDEN output Is used to turn the sound hardware on and off as 
described In the Sound Hardware document. A value of is the "on" state 
and a value of "I" is the off state. Changing this bit from within a user 
program is harmless as the worst possible event is simply a constant sound 
output. 

The VSVNC input Is used as an Interrupt upon svhlch many time related 
tasks are performed by the Macintosh operating system. !t will go low 
during every vertical retrace. (A rate of 60.1474 Hz.) This input could also 
be used to perform such things as flicker free video page switching. 

The KBD.CLK Is generated by the keyboard/keypad to transfer data to and 
from the shift register In the 6522. Data enters and exits via the 
KBD.DATA line. These two lines are of use only when writing a 
replacement keyboard driver. 

Overall, attempt to use an operating system routine to alter these i/0 
bits to retain compatibility with different hardware (such as the Lisa). 
Where this is not possible, make sure that the system Is a Macintosh and 
carefully alter the needed bits. 
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SU1 


Pfl2 


Output 
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PflS 


Output 


SMO . PG2 


PR4 


Output 


GUERLRV 


PflS 


Output 


DiSKOUT 


Pfl6 


Output 


UiD.HU2 


PR7 


input 


SCCU/REQ 


PBO 


Input /Output 


RTC.DflTfl 


PB1 


Output 


RTC.CLK 


PB2 


Output 


RTC.EN 


PB3 


input 


MOUSE. sue 


PB4 


Input 


riOUSE.X2 


PBS 


Input 


MOUSE. V2 


PB6 


Input 


HSVHC2 


PB7 


Output 


SOUHDEH 


Cfti 


Input 


USVNC 


CR2 


input 


RTC.1H2 


CBI 


Input 


KBD.CLK 


CB2 


Input /Output 


KBD.DflTR 



Low order bit of volume select 

Middle order bit of uoiume control 

High order bit of Moiume control 

Sound/disk page select 

R0ri/RRf1 select 

Disi< command output 

Mideo page select 

DMA request signal from SCC 

Data to /from RTC pin 6 

Data clock to RTC pin 7 

Enable signal to RTC pin 5 

Mouse button input 

Flouse quadrature input 

Mouse quadrature input 

Horizontal sync signal 

Sound PUM enable /reset 

Uertical sync interrupt input 

1 Hz square wave from RTC pin 1 

Data clock input from keyboard 

Data to from keyboard 
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Mouse Hardware 

At any moment of time, the position of a mouse can undergo three 
possible state changes (for each axis of movement). These are: move left, 
stay in place, and move right. Information about these state changes must 
be sent out of the mouse. Basically, two ways exist to do this: either the 
computer can be told of each change or the mouse can output it's present 
position from which each change can be deduced. The first method is 
difficult to do with a limited amount of hardware since two (or more) 
successive "move left" operations must be distinguishable from just one. 
Thus the second method is employed in most mice. 

Encoding the full mouse pointer position in the mouse hardware itself is 
not practical because of the amount of data this would require. Thus, the 
mouse sends only the minimum amount of information needed to decode each 
movement. (This movement is then used to control the pointer movement.) 
Three distinguishable positions are enough to express ail of the three 
possible state changes. These three positions are: the next left, the 
present, and the next right positions. Because these must be encoded as a 
binary number, at least 2 bits are needed. However, 2 bits of data can 
encode a total of four values so thus four positions are used. Note that at 
any time, only three of the four will be used. 

Four consecutive positions of the mouse could be nunribered 0, I, 2, and 3. 
V/hen the mouse is in positions I or 2, it always has another position 
available to the right or left. This is not true for locations and 3. 
Therefore, the number codes repeat as the following endless sequence: 
... 2 3 1 2 3 1 2 ... As the mouse moves in either direction, it 
traverses this set of numbers. 

The encoding of these position numbers in binary must be done in a 
special way. The initially obvious way of mapping them in the standard 
numerical binary sequence (0 to 00, 1 to 01, 2 to 10, and 3 to 1 1) will not 
work. Two of the transitions (1 <-> 2 and 3 <-> 0) in this type of coding 
have more than one bit change. Since the binary values will be generated 
mechanically in the mouse, the two transitions cannot be guaranteed to be 
simultaneous. Vv'hat is needed is a coding where one bit changes at a time. 
(This is knosvn as a Gray code.) The only 2 bit Gray code is: ..., 10, 00. 01 , 
1 1, 10, 00, ... read in either direction. The Macintosh mouse uses this code. 
When this sequence is graphed with respect to time, the result looks like 
two square waves that are 90 electrical degrees offset from each other (one 
cycle is 360 degrees). For this reason, such signals are often said to be in 
quadrature. 
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Listing 1 - Mouse signal demonstration program 

to IRB= 15720958* 

20 M0USEK1 = 10485754* 

30 MOLISEVI = 10485752* 

100 IF PEEK(MOUSEVI) AND &H8 THEN PRiNT "I"; ELSE PRINT "O" 

no IF PEEK(IRB) AND &H20 THEN PRiNT "1 "; ELSE PRINT "0 ■',; 

120 IF PEEK(MOUSEXI) AND &H8 THEN PRINT "1".; ELSE PRINT "O"' 

130 IF PEEK(IRB) AND &H10 THEN PRiNT "1 ".; ELSE PRINT "0 ■■; 

140 IF PEEK(IRB) AND &H8 THEN PRiNT "1" ELSE PRiNT "O" 

150 GOTO 100 
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00 


NOP 


003 


08 


IH ft,PO 


004 


53 20 


aNL R,«$20 


ru~i-=. 


C5 fi8 


J2 $0fl8 



;8021PfiGE0 - Ccmments by The iM Underground (C> 1985 

; D i sassemb i y listing of tha Mcicintosh Keyboard and 
; Keypad control isr (intst 8021 I1PU> ROM.' Hay 1984. 
;This code continual !y scons the keyboard and reports 
;ar>y changes to the ficicintosh. 

jThe chip from uihich this code luas read was marked: 
;P8021H 2173. !t had a date code of 8352. It did 
J not haue any copyright in or on it other than tha 
.; Intel copyright for tha CPU design. 

;The approximate clock rate of the MPU is 3 hhz. 
jThis results in a CPU cycle time of slightly under 10 uS. 
; R I ! of tha quas i -b i d i rsc t i ona i p i ns have i n tsr na I 
jpuMup resistors. 

j Entry point of hardware <poujer-on> RESET 

000 54 89 CALL 289 ;init system Rflll and timer 

j Re looping entry point - check for operation mode 

; Oe i ay 

;Find out if keyboard or keypad 

;Mask for oniy P05 input 

; i f j umpered to ground , uje are a keypad 

.; Keyboard main loop 

008 34 92 CRLL $192 ;Scan the keys 

38 30 MOU R0,»$30 :Load pointer to outgoing FIFO 

Eo 14 JNC $014 ;if no keyoush, then skip 

OOE 54 R8 CALL $2fl8 ;Piace key stroke in the FIFO 

010 54 B6 CRLL $2B& ;lnit timer 

012 04 2B JMP $028 ;Go attempt to send the byte 

014 FO MOU flJ'RO ;Get first byte in FIFO 

015 96 29 JNZ $029 ;if old data is present, try to send it 

; Check for inactive timeout 

017 16 IB JTF $01B jif timeout 

019 04 2B Jf1P $02B ; Figure tvhat there is to do 
Olt: SS 2E hOU R0.«$2E ;Load pointer to flag 

01D FO MOU R,?RO ;Gat the Ma iue 

01E 53 02 RNL fl,tt$02 ;See if inactive for too long 

020 96 25 JNZ $025 ■ ;Yes 

C22 10 IMC iRO ;fesp track of inactive time 

023 04 2B JMP $02B ;Go figure out M/hat to do 

025 B3 30 MOU R0,»$30 ';Load pointer to FIFO 

027 BO 7B MOU ?R0,«$7B ;Load "I'm awake" coda and try to send it 

029 54 B6 CALL $285 -Init timer and reset idle counter 

; Decide wjhat needs processing and go do it 

02B 33 2F MOU R0,»$2F jLoad pointer to received data 
020 FO MOU fl.S'RO ;Get present value 



02E 95 4E JNZ $04E ;Ssnd a byte if our turn stiii 
_ ; fit tempt to rscaive a command and process it 



ScsiTipie sarial input 

if inactive, then reioop 

Receive a data byte 

Get recsiued data 

See i f request for data cotnmand 

Respond uj i th resu ! t 

Get receiMed data 

See if permission to sand 

Try to sand a data byte 

Get received data 

!s it reset command? 

Reset the keyboard and return $03 

Get received data 

is it a se i f tes t command? 

Go do the self test routine 

C I BQr rsce i ve by te 

if none of those,, reioop 



u9& 


54 


BF 


CftLL $2BF : 


032 


F6 


02 


JC $002 ; 


034 


74 


CF 


CfiLL $3CF : 


035 


FO 




MOU fl.g'RO : 


037 


D3 


14 


XRL fi,«$14 ; 


039 


C5 


5F 


J2 IQ5F ; 


03B 


FO 




MOU R.gRO 


03C: 


D3 


10 


XRL R,«S10 


03E 


C5. 


4E 


JZ $04E : 


040 


FO 




MOU R.i'RO ; 


041 


D3 


16 


XRL R,»$16 ; 


043 


C6 


51 


JZ $051 ; 


045 


FO 




MOU fl.gffO ; 


046 


D3 


36 


XRL R.«$36 ; 


048 


ce. 


63 


JZ $063 ; 


04fi 


BO 


00 


MOU eRO.^lOO ; 


04C 


04 


02 


jriP $002 ; 



05F 

•JiJ I 



fry to send a byte from the $30 FIFO 



04E 


B8 


30 


MOU R0,»30 


050 


FO 




MOU R.i'RO 


051 


C6 


02 


JZ $002 


053 


54 


Bfl 


CRLL $2BR 


055 


16 


30 


JTF $030 


057 


54 


BF 


CALL $2BF 


059 


E6 


55 


JNC $055 


m 


74 


8C 


CALL $3SC 


m 


04 


02 


JMP $002 



;Load pointer to FiFO 

jGet first byte 

; Re I OOP i f empty 

;Set tiiTier to timeout i ru ?0ms 

jExit loop after t!~iaout 

jSarrspie P20 serial data input 

;Uait until timeout or serial line inactive 

jSend a byte of data 

; Re I OOP 



lUectors to short code bioci<.s in paqe 3 



54 IB 
54 26 



JMP $318 
JMP $325 



;Link to respond mith data coda 
; Reset keyboard (return $03) 



063 


B8 


02 


065 


89 


3E 


067 


BO 


RR 


059 


IS 




06fl 


E9 


67 



;Pert"orni RfiM rriamory test. 

jEntru Hone 

;Exit RO = $36 

: <R0) = result flag $7D = OK $7? = Error 

; Rest of Rfi?1 reinitialized 

.;Uses fill 

;Fiil RRM atth one bit pattern 

MOU R0,»$02 ;Load starting test address 

MOU R1,«$3E ;Load size to test (52) 

MOU ?RO,«$RR ;Put value into RRM 

INC RO ;RdMance pointer 

DJNZ R1,$067 jLoop through all locations 



; Check if all locations held this value 



05C 


B9 3£ 


Q5E 


B3 02 


070 


FO 


li 


IS 

D3 flR 


074 


06 80 


075 


E9 70 



078 


B9 3E 


r-10U R1,«$3E 


07fl 


88 02 


MOU R0,»$02 


07C 


BO 55 


MOU §r6,#$55 


07E 


13 


INC RO 


07F 


E9 7C 


DJNZ R1,$07C 



MOU Rt,«$3E ;Load size aqain 

MOU R0,«$02 jLoad start again 

MOU RjiRO ; Fetch yaiue there 

INC RO ; Advance pointer 

XRL R,«$flft ;Sae if it mas $fifl 

JNZ $080 ; I f error, ex i t 

OJNZ R 1,1070 ■Loop for rest of RRn 

;Fiii RAM with other bit pattern 

;Load size again 
;Load start again 
;Put (NOT $RR> in RRil 
.; Advance pointer 
;Loop for all of ffierriory 

; Check if i t ha i d everywhere 



031 


B9 


3E 


MOU R1.«$3E 


;Load size 


083 


B8 


02 


nOU R0.»$02 


;Load start 


085 


FO 




MOU fl.SRO 


;Get value from Rflti 


086 


18 




!NC RO 


;Rdvance pointer 


087 


D3 


55 


XRL fl.»$55 


; See i f error 


0S9 


95 


SD 


JH2 $080 


; i f so , ex i t 


08E 


E9 


85 


DJNZ R1.$085 


;Lcop for rest of RRM 



; Reset back to operational state 

.:Get finai value of counter 

; Save it in R2 

; Ini t system 

; I n i t t i mer to 

;Get result back 

; I f there luas an error . . . 

jLoad pointer 

jLoad OK code 

; Send the resu I t code 

;Load pointer 

;Load error code 

; Send the resu 1 t code 

;Take up space 
; Take up space 
;Take up space 
;Take up space 
jTake up space 
;Take up space 

; Keypad main loop entry point 

0R8 23 01 nCU fl,«$01 ;Load mask 

ORR 54 CC CALL $2CC ;Set keypad mode flag 

;See if keyboard comiTiuni cat ions must be done 

ORC B8 2C MOU R0,«$2C ;Load pointer to flag 
ORE FO MOU R,i'RO ;Get the value 



08D 


F9 




MOU 


R.R1 


OSE 


Hfl 




MOU 


R2.fl 


OSF 


54 


89 


CRLL 


. $289 


f^^ 


54 


B6 


CALL $2B5 


V 


Ffl 




MOU 


fl,R2 


094 


96 


9C 


JNZ $09C 


096 


BS 


36 


MOU 


R0.ft$36 


098 


BO 


7D 


MOU 


mb, »$7D 


09R 


04 


53 


JMP 


$053 


09C 


B8 


36 


MOU 


R0,*$3& 


09E 


BO 


77 


MOU 


§R0.«$77 


GflO 


04 


53 


JMP 


$053 


0fl2 


00 




NOP 




Ofl3 


00 




HOP 




0fl4 


00 




NOP 




OflS 


00 




NOP 




Ofl& 


00 




NOP 




0R7 


00 




NOP 





OBC 


23 


14 


nou H.#$i4 


OBE 


74 


2E 


CALL $32E 


OCO 


C5 


C3 


JZ $ocs 


0C2 


23 


SO 


MOU fl.a$90 


0C4 


54 


CC 


CALL $2CC 


0C5 


04 


D7 


JHP $0D7 


OCS 


23 


7F 


nou fl,»$7F 


OCfi 


54 


D1 


CRLL $2D1 


OCC 


74 


60 


CALL $35D 


OCE 


FD 




MOU R5,H 


OCF 


D3 


7B 


XRL H,»$7B 


GDI 


C& 


D7 


J2 $0D7 


0D3 


B8 


30 


MOU Rn.«$30 


0D5 


54 


flS 


CRLL $2fi8 



ORF F7 RLC ft iTsst keyboard absent flag 

OBO E5 BC jrc $03C :lf present then talk to keyboard alwaus 

0B2 B8 2B MOU R0,s$2B ;Load a flag pointer 

■^ 10 INC ?R0 ; Count ioooi 

8W FO nou R,§F!0 .;Gat result 

0B6 97 CLR C ;Set up for 6502 type PiDD 

0B7 13 F8 flDDC fl,,»$F8 ;Sae if result was' less than 8 

0E9 E5 D7 JNC $0u7 ;Try to find keyboard oniy every 8 passes 

OBB fiO nou i'RO.fi ;Load new result <0> 

;fisk keyboard for data 

;Load command byte 

;Send the byte to the keyboard 

; ! f the keyboard took the byte 

;Load mask 

;Set keyboard absent fiaq 

jSkIp ahead 

jLoad mask 

jCi ear keyboard absent flag 

iReceiMe return code from the keyboard 

; Save i t 

; See i f no chanqes cods 

; 1 f so, then don't giue to Mac 

;Load FIFO pointer 

.;Savs the returned vaJue 

jScan Keys and put result in the keypad FIFO 

;Scan keys 

; i f nothing changed 

;Load FIFO pointer 

; Save resu i t 

; Check FIFOs for data 

; Don't bother luith awaka stuff if data to send 

; Account for extra tise taken to talk to keyboard 

;Load flag pointer 

j lie t the f I ag fay te 

; Check the keyboard present flag 

; i f present, send airake codes at faster rate 

;Load mask 

;Fi ip 01 of flag byte 

.: Rep I ace resu 1 1 

j Check new status of D1 

;Serid data at half rate if keyboard absent 

;Check if "awake code" <or "no changes") should be sent 

;Load pointer to another flag 

j Count loops 

; Rep I aca resu 1 1 

;Set up for 6502 type ADD 

jEssentially see if R was less than 28 

jif so, then continue 

;Load new result <0> 



OD? 


54 53 


CRLL $253 


ODy 


E6 DF 


JHC $GDF 


m 


B8 3fl 


nou R0.»$3fl 


54 fiS 


CRLL $2fi8 


CDF 


74 OE 


CALL $30E 


0E1 


Fd FD 


JC $0FD 



0E3 


B8 2C 


MOU R0,»$2C 


0E5 


FO 


MOU fi.g'RO 


0E6 


F7 


RLC A 


0E7 


E& F1 


JHC $0F1 


0E9 


23 02 


MOU A,«$02 


OEB 


00 


XRL a,?R0 


OEC 


AO 


MOU 5'RO.A 


OED 


53 02 


RNL fl,«$02 


OEF 


96 FD 


■jnz $6fd 



0F1 


B8 2E 


MOU R0,3$2E 


0F3 


10 


IMC ?R0 


0F4 


FO 


MOU R,?RO 


0F5 


97 


CLR C 


0F6 


13 E4 


RDDC A.»$E4 


OPS 


Eo FD 


JHC $OFD 


OFfl 


flO 


MOU g'RO.n 



OFfci 24 IF .J1P $11F ;Send an awake coda 
; Check for what needs to be done 



efl 








iSfb 


B3 


2F 


MOU R0,8$2F 


OFF 


FO 




MOM fl.efiO 


1D0 


go 


OS 


■jnz $103 


102 


54 


BF 


CfiLL $2BF 


104 


F5 


ID 


JC $110 


106 


74 


CF 


CRLL $3CF 


108 


~:-~> 
UO 


14 


XRL R,«$14 


10R 


CD 


1F 


•JZ $11F 


IOC 


FO 




MOU R.i'RO 


10D 


03 


10 


XRL fl,»$10 


10F 


C6 


25 


JZ $125 


111 


FO 




MOU fi.i'RO 


112 


D3 


16 


XRL fi,*$16 


114 


05 


5E 


J2 $16E 


115 


FO 




hOU fl,§RO 


11? 


53 


40 


RNL r',*$40 


1 19 


96 


82 


JNZ $1S2 


113 


04 


45 


JhP $045 



110 



IIP 

121 



125 
12? 
128 
12H 
12C 
12D 
12F 



04 RC 



74 OE 
F6 25 
BO 7B 



BS 3fl 
FO 
C& 5B 

FO 

53 04 
96 4? 



;Load pointer to S!0 flag byte 

; Oe ♦. the va I ue 

;ir It contained a command 

;Test P20 input from Mac 

; i f i nac t i Me , re i oop 

; Race i ye the byte frorri the flac 

;See if it a data request command 

;Send a response to the flac 

;Get the byta again 

; Check if it was perm i ss i on to send 

; ! f so 

;Get the byta again 

; is it a reset command 

; i f so 

;Get command again 

; Check for special keyboard self- test flag 

;Te!l the keyboard to test itself 

; Check for keypad self test or HOP 



jBranch to top of loop in different page of ROil 
JMP $ORC Uector to start of keypad loop 
;Set up to send data or Qf] awake code 



CALL $30E 

JC $125 

MOU g'R0,»$73 



j Check FIFOs for data 
; i f some data there 
;Piace response at <$30) 



131 


B8 36 


MOU R0,«$36 


133 


BO 79 


nou gP.0,»$79 


135 


54 BR 


CRLL $2BR 


13? 


16 02 


JTF $102 


139 


54 BF 


CRLL $2BF 


13B 


E6 3? 


JHC sTo? 


13D 


74 SC 


CALL $3SC 


13F 


54 B6 


CRLL $2S5 


141 


23 04 


nou fl,»i04 


143 


54 CC 


CRLL $2CC 


145 


04 fiC 


JhP $ORC 



:3end a byte to the Mac if it exists 

nou F;0,*$3fl ;Load pointer 

MOU R,?RQ -Gat the byta 

JZ $15B jif nothing in keqpad FIFO 

nm R0,»$2C ;Load fiaq' pointer 

MOU R.SRO -Get contents 

RHL R,«$04 ji'iask for D2 

JNZ $14? jIf the prefix ujas sent, send a data byte 

;Send a $79 keypad data prefix to the Mac 



jLoad pointer 

Load data to be sent 

Clear timer 

On timeout, try to receive a byte 

Test P20 input 

i4ait until Mac does not want to send 

Send a byte to the Mac 

Reset tiiTier and timeout mask 

Load mask 

Set prefix sent flag 
; Re i oop 



;S021PfiGE1 - Comrnsnts by The IN Underground <C> 1985 

;Scan tha keyboard and return the naeded codes 

; Entry None 

, Ex i t CV = I f no va i i d change 

; CY = 1 ! f a ua ! i d change 

; fl = R5 = Resu I t code 

; Uses R , F , RO , R t , R2 , R3 , R4 , R5 ,, R6 , R7 ., &2 

MOU R 1 , ^$34 ; Load po i n ten i n to F i F 
MOU R,§R1 ;Get last byte in FIFO 
JZ $199 ; ! f rooui in FIFO for another key 
CLR H ;*** THIS IS fl BUG! *** 
jThe above line should be CLR C to fiag no changes, fis is, 
; i f tha FIFO is full and CV iuas sat prior to calling this 
; routine, The last entry wiii be smashed with the present 
j contents of R5. However, another pair of bugs that dc not 
;aiioi.i.i the entire FIFO to be used, iuiii causa this code to 
; OA^f^r- f ! nd a F i FO f u I i cond i t i on and thus th i s buo i s 
.: bypassed. 
1 98 33 RET j Don ' t scon i f no space 



192 


B9 


34 


194 


Fl 




195 


C5 


99 


197 


27 





j Perform a scan 



199 


B9 


20 


;-10U R1,»$20 


1QB 


23 


FD 


nOy fl,3$FD 


190 


3R 




OUTL P2.fl 


19E 


34 


EE 


CRLL $1EE 


IFiO 


25 


FF 


MOU H,«*FF 


1fi2 


3R 




OUTL P2,R 


m 


F6 


93 


JC $193 


m 


•-..-: 
^■1' 


FE 


MOU R,3$FE 


1fi7 


RS 




MOU RO.R 


1fl8 


39 




OUTL P 1 . fl 


1fl9 


19 




mc R1 


Iflfl 


34 


EE 


CRLL $1EE 


IRC 


23 


FF 


MOU fl,«$FF 


IRE 


39 




OUTL P1,R 


IflF 


F5 


BD 


JC $1BD 


1E1 


F3 




MOU fl.RO 


1B2 


B7 




CPL C 


1B3 


F7 




RLC R 


1B4 


F& 


R7 


JC $1fl7 


1B6 


19 




INC R1 


1B7 


54 


D6 


CALL $206 


1B9 


D1 




XRL fl,§R1 


lEfl 


9& 


BE 


JN2 $1BE 


1BC 


97 




CLR C 


1BD 


1-1 .-t 




RET 



jLcad pointer to key status array 

;Load output data 

j Enable P21 output 

;Test this roiu of keys 

;Load inactive data 

;Turn outputs off 

; Ex i t if thera ujgs a change 

;Load starting scan code 

; Save i t 

; Select a scan 1 ine irc-m PI 

;Rdvance key status i€t's pointer 

jTast this rcun of keys 

;Load inactive value 

j Deselect the port i- ine 

; Ex it if t.hers utas a change 

;Get current scan status 

jSet CS' 

jMova the scan ! ine to the left 

; Re loop for another line 

:RdMance table pointer to shift status 

;Get the shift key status 

;See if anything changed 

; 1 f thara asas a change - process i t 

jFiag no changes 

;Done 



: Compute the key codes of a SHIFT type key 

; En try fl = Change mask 

; R1 = Pointer into status table 

; Ex i t CV = i f no Kfa I i d change 

; CV = 1 I f a <:>Q i i d change 



fl = R5 = Result code 
;Usas 8,F,R2,R3,R4,R5,g;1 



m 


54 


E7 


CRLL $2E7 


m 


54 


R1 


CRLL $2fl1 


1C2 


54 


D6 


CALL $2D6 


!C4 


pi 




now 


R.§R1 


1C5 


5S 




RHL 


fi,R3 


1C6 


flC 




nou 


R4,fl 


1C7 


FD 




fioy 


fl,R5 


1C8 


53 




flNL 


fi,R3 


1C9 






XRL 


r'R4 


ica 


C5 


BC 


JZ : 


MBC 


ICC 


FB 




nou 


fl,R3 


1CD 


D1 




XRL 


fl,SR1 


ICE 


fi1 




MOU 


i'RI.H 


1CF 


FB 




nou 


fl,R3 


1D0 


5? 




RRC 


fl 


IDi 


E6 


07 


JiiC 


$1D7 


1D3 


23 


75 


MOU 


fl,«*$75 


1D5 


24 


E9 


JtlP 


$1E9 


1D7 


6? 




RRC 


R 


IDS 


E5 


EO 


JNC 


$1E0 


IDR 


23 


71 


MOU 


R,«:|;71 


IDC 


24 


E9 


JMP 


$1E9 


IDE 


00 




HOP 




IDF 


00 




HOP 




1E0 


5? 




RRC 


R 


1E1 


E6 


E7 


JMC 


$1E7 


1E3 


23 


6F 


MOU 


fl,«$6F 


1E5 


24 


E9 


JMP 


$1E9 


M 


23 


73 


nou 


R . »$73 


W 


4ft 




ORL 


R,R2 


1Efl 


RD 




MOU 


R5,R 


1EB 


97 




CLR 


C 


lEC 


fl? 




CPL 


Q 


1ED 


33 




RET 





Compute a change iiiask 

Delay 4.2 .iis for dabounca 

Read shift status agaifi 

Get oid status 

Mask for only currant key 

Save the resu 1 t 

Now fetch the shift status 

Mask it for only the current key 

See if old and present status is safrse 

Exit if this key "bounced" 

Get the changed mask 

Change the bit in tha array 

Rep i ace the nsuj resu 1 1 

Compute key number from the mask 

Test if it was OPT 1 OH 

if not. skip to next test 

CPT!CM'= 53 

Skip to end 

Was it SHIFT? 

if not, skiD to next test 

SHIFT = 55 ' 

Skip to end 

Take up luaste space 

Take up waste space 

See i f iuas CTRL 

if not, assuiTie CfiPS LOCK 

CTRL = 55 

Skip to end 

CRPS LOCK = 57 

Combine with pushed/released info 

Save resu 1 t 

Put a zero there 
, Set Cv to show key 
; Done 



; Debounce a keyboard key read from PO 

; Entry R1 = Pointer to key status table 

j Ports set up to read the keys from PO 

; Ex i t CV = I f no va i i d keypush 

; CV = 1 I f a va I i d change 

■ fl = R5 = Result code 

; Uses fl, F, R2, R3, R4, R5, R5, R7, & 1 



1EE 


00 


iNOP 


Delay 




1EF 


08 


IN fl,PO 


Get key status 




1F0 


43 CO 


OR fl,*|CO 


Rerriove non-scan i ines 




1F2 


RD 


MOU R5.fi 


Save resu i t 




1F3 


D1 


XRL fl,g'R1 


See i f there mere any >: 


;hanges 


1F4 


96 F8 


.JNZ $1F8 


If so 




1F6 


97 


CLR C 


Flag none 




1F7 


S3 


RET 


Ex i t then 





; Debounce a key and compute it's return coda 



1F8 


54 


E7 


CftLL $2E7 


1FR 


54 


fl1 


CALL $2ai 


1FC 


F1 




nou a^tRi 


1FD 


5B 




flHL fl.RS 


1FE 


flC 




MOU FA.fi. 


IFF 


F8 




MOU R.RO 


200 


flE 




MOU R6,Fl 


201 


BS 


2C 


nou R0,«$2C 


203 


FO 




MOU fl.gRO 


204 


67 




RRC R 




F5 


1 1 


JC $211 


207 


CO 




HOP 


203 


OS 




IN pi_pn 


20Q 


53 




hNL ri,R3 


20R 


DC 




XRL a,H4 


20B 


Q5 


27 


JH2 $22? 


20B 


FE 




MOU R , R5 


20E 


R8 




MOU RO..H 


20F 


97 




CLR C 


210 


83 




RET 


• 


F9 




MOU R,R1 


03 


24 


XRL fl>$24 


214 


CS 


07 


JZ $20? 


215 


D3 


07 


XRL R,*$07 


218 


95 


ID 


JN2 $2 ID 


21R 


09 




ifi R.P1 


21B 


44 


09 


JMP $209 


210 


oa 




m R.P2 


21E 


77 




RR fl 


21F 


43 


F9 


OR fi,»$F9 


221 


55 


09 


JT1 $209 


223 


53 


FE 


HND R,«$F£ 


225 


44 


09 


JMP $209 


22? 


B8 


20 


MOU R0,a$2C 


229 


FO 




MOU R.?RO 


22fl 


53 


08 


fiHD H.«$08 


22C 


96 


41 


JHZ $241 


22E 


BS 


2D 


MOU R0,«$2D 


230 


FD 




MOU fl.RS 


231 


5B 




RHL fl.RS 


232 


Co 


3S 


JZ $23B 


234 


FO 




MOU fl,§RO 


235 


C5 


41 


JZ $241 


237 


07 




CEC R 


238 


fiO 




nou gRO.R 



; Entry R = "Changed itiosk" 

; R1 = Pointar to key status table 

; R5 = Initial read status of keys 

; Scan i ins sat up to read the keys 

; Ex i t CV = ! f no va i i d change 

CS-" = 1 1 1" >;<a ! i d change 

; R = R5 = Rssu I t code 

iUses a,F,R2,R3,R4,R5,R6,P.7,,ai 

; Compute mask of one of the keys 

; Del ay 4.2 ss 

;Get the present status 

; Mask i t for on I y one key 

; Save resu I t 

;Get contents 

;"PUSH" it 

jLoad pointer 

;Get fiaq byte 

; Check Isb 

;'f set (performed as if keypad) 

; De 1 ay 

;Oat status of keys again 

jMask for only the present one 

;See if status change still present 

j S'es - then a ya i i d change 

;"POP" old FiO con tan ts 

; Rep lace them 

.:F!ag no changes 

; Done 

_; Get tab I e po i n tsr 

;See if 24 

;Then status copies from PO 

; See i f was 23 

; ! f the scan is rriu 1 1 i p ! exed 

;Get keys from here 

;Join rest of code 

; Get mu ! t i p I exed keys 

jToss P20 

jMask for only F22,P23 

J if OK, then join rest 

;Copy T1 to DO 

;Juin rest of code 

jLoad pointer to keypad flag byte 

;Get the flag 

jTest a bit (This m\\ \ aliuays bs a Q> 

; Sk i p 2-key ro i I over ! i m i t i nq 

;Lcad pointer to * of keys pushed 

;Get scan result 

;Mask for the present key 

; 1 f it uias pushed 

;Get present value 

j Don't let i t go negative 

j Remove one 

; Rep I ace resu i t 



239 


44 


41 


jrip 


$241 


23B 


FO 




nou 


fl,iRO 


23C 


53 


02 


RHL 


fi,«$02 


"• ' 


96 


OD 


JNZ 


$200 


L .J 


10 




irc 


i'RO 


241 


rO 




nou 


P,,R3 


242 


D1 




XRL 


a,§Ri 


243 


Hi 




nou 


i'RI.R 


244 


F9 




nou 


R,R1 


245 


53 


OF 


RNL 


fl,s$OF 


24? 


RE 




nou 


R6,fl 


248 


97 




CLR 


C 


249 


E7 




RL fi 


24R 


E7 




RL R 


24B 


7E 




RDDC a,R6 


24C 


7E 




RDDC 


; fi,R5 


24D 


7F 




RDDC fl,R7 


24E 


R7 




CPL 


C 


24F 


F7 




RLC 


R 


250 


4R 




ORL 


fl,R2 


251 


24 


Efl 


JMP $1ER 



;Skip to rania ining coda 

.;Get flag value 

; Sea i f 2 kays pushed 

; If so, then don't take this one 

.: Count keys pushed 

;Oet mask 

jFiip status of that one key 

; Rep I ace resu i t 

;Get table pointer 

; Compute the offset from start <20> 

; Save ya i ue for mj 1 1 i p I y by & 

jClear to a! iow 6502 style'flDD 

jTimes 2 

; Times 4 

; Times 5 

; Times 6 

jRdd position in this roui of the ket 

; Se t it (. was still c i ^or- ') 

;Make isb a one (for a stop bit> 

; Combine yjith pushed/re leased info 

; Jo i n ex i t code 



;Scan keypad keys 

; En try None 

; Ex i t CV = i f no change found 

; Cy = 1 i f change found 

; R = R5 = Resu 1 t code 

; Uses H , F , RO , R 1 . R2 , R3 , R4 , R5 , R6 , Rl 



--.cr--. 


B8 


3E 


MOU nO,«$3E 




FO 




Hou h.Iro 


255 


97 




CLR C 


257 


C5 


5R 


JZ $25a 


259 


S3 




RET 


25fl 


23 


FB 


i10y H.^$FB 


25C 


B9 


20 


nou R1,a$20 


25E 


R3 




nou Ro,a 


25F 


SO 




OUTL PO.R 


250 


54 


7fi 


CRLL $27fl 


262 


23 


1 1 


nou fi,»$FF 


254 


90 




OUTL PO.fl 


265 


F6 


79 


JC $279 


257 


1Q 




INC R1 


268 


fl7 




CPL C 


259 


FS 




nou Fi . RO • 


26fi 


57 




RRC fl 


26B 


F6 


5E 


JC $25E 


25D 


09 




IM R,P1 


26E 


54 


'?:Z' 


CRLL $292 


270 


Fd 


79 


JC $279 


272 


19 




INC R1 


273 


00 




MOP 


274 


OS 




IN fi,PO 


275 


43 


E7 


ORL fl,«$E7 


277 


44 


82 


JMP $2S2 



;Load buffer pointer 

;Get last byte of buffer 

;Get ready to show no change 

;lf space in buffer 

; Don ' t do any th i ng 

; Load initial mask va I ue 

;Load pointer to key status 

;Save port value 

; Select a scan line 

;Scan this group 

;Load inactive value 

; Deselect the line 

.; i f a key change was found 

jRdvance table pointer 

;Set it 

;Get present select byte 

;f1ove over to right 

; I f not done yet 

;Get status of some more keys 

•Test these 

; ! f a change 

;Rdvance table pointer 

j De I ay 

;Get remaining keys 

; Mask for on 1 y tiuo i i nes 

; Check these 



; En try Hone 

:Exit" a = T = $00 

; TF = 

;Uses fi,TF,T 

2Bfl 27 CLR fl ;Load 

jLoad Q yalue to the timer 



; This routine can be used to initialize the tiiner 
jcnd to ciecir the timer flag. 

;Entru fl = Data 

;Exit T = R 

: TF = 

;Usas TF.T 



2BB 


62 


nOU T,R 


;Send it to timer 


2BC 


16 BE 


JTF $23E 


; Clear timer flag 


2BE 


S3 


RET 


; Done 



;Copy P20 Input to CV 

; This routine wiii test the P20 serial line. It 
;ujill do a smaii amount of checking for noise also. 

;Entri4 P20 = 1 <to aMoui input) 

P20 



; C ! Bar resu It f ! aq 

;Get P2 data 

; flask for P20 input from tlac 

.; 1 f actiya, sxi t 

;6et data again 

; Check it again in case of noise 

;Exi t if active now 

;P20 '!ias a one 

;Bons 



;0F; H to flag 

; This routine can be used to set bits in the 
; opt ions flag byte. 

; Entry fi = Mask 

;Exrt fi = Result 

: RO = $2C 

; <$2C> = C$2C> OR ft 

;Uses fl,R0,<$2C) 

2CC B8 2C nOU R0,«$-2C ;Load address pointer 

2CE 40 ORL R,§RO ;0r ne«j value to old 

2CF RO MOU §RO.R ; Replace result 

200 83 RET ;Done 







;Exit CV 






; Uses H, i 


M 


Q7 


CLR C 


W 


Oft 


IN ft,P2 


2C1 


53 01 


RNL fl,«$01 


2C3 


C6 C3 


J2 $2CB 


2C5 


Oft 


IN ft,P2 


2C6 


53 01 


RNL a.s$oi 


2C8 


C5 CB 


JZ $2CB 


2CR 


R7 


CPL C 


2CB 


S3 


RET 



;fiHD a to f'iag 

; This- routine con be used to ci ear bits in the 

; opt ions ficig byte. 

; Entry fi =Ma£k 

.Exit fl = Result 

; RO = $2C 

; <$2C> = CteO AND R 

;U£es fl,R0,<$.2C) 

2D1 S3 2C MOU RCi,*$'2C ;Load address pointer 

2D3 50 fiHL fi.SRO jflnd nm value 

2D4 fiO MQU g'RO.f! ; Rap i ace resuit 

2D5 S3 RET ;Done 



jRead speciai keys from keyboard 

: This subroutine wi i i read the status of the 
; special i':.ays on the keyboard and return the 
; result in the format naadsd for ths key 
; tab i e . 

; Entry P06 = P22 = F'23 = 1 

;Exit fl = R5 = Result (0 = pushed) 

: DO = OPTION 

'; 01 = SHIFT 

; 02 = CTRL 

; D5 = CRPS LOCK 

; D3-D5.D7 = 1 



;i3et special key status 

;Throi» aaay P20 serial input 

;Mask for only SHIFT and CTRL 

;Te£t OPT! CM 

; Transfer it to DO mith other keys 

;Clear bit for CAPS LOCK status 

; Save resu i t 

;Get CRPS LOCK status 

; Nask for on i y it 

; Combine luith other status 

; Rep I ace resu 1 1 



;Set up masks for a keypush 

jThis routine mill take a mask with I's at the locations 
; where a key changed state and single out one of them 
;and prepare a mask to use to process it further. Keu 
; re I eases ars processed first so that the Mac does not 
jsee Biore keys pushed at any ti^e than there really are. 









;Uses R,R5 


2D5 


OR 




IN fl,P2 


2D7 


77 




RR a' 


2D8 


43 


F9 


OR fi,«$F9 


2DR 


55 


DE 


JT1 $2DE 


2DC 


53 


FE 


RNL fl,8$FE 


2DE 


53 


BF 


RNL fl,«$BF 


2E0 


RD 




nm F;5,R 


2E1 


09 




IN R,PO 


2E2 




40 


RNL R,*i40 


2E4 


40 




ORL fl.RD 


2E5 


RD 




MOU R5,R 


2E6 


S3 




RET 



: tx i t 



Uses 



n = "Changed" mask 

.R1 = Pointer into kay stcstus table 

Fi2 = $00 (pusiied) or $30 (re leased) 

R3 = Bit set ujher-e the change occurred 

R7 = Bit number of the keu <0-7> 

fl,F,R2,R3,R4,R6.R? 



2E7 


BB 


FF 


MOU R3,«$FF 


2E9 


RE 




nOU R6.ft 


2Efl 


97 




CLR C 


2EB 


57 




RRC fl 


2EC 


1B 




INC R3 


2ED 


E6 


EB 


JHC $2EB 


2EF 


fiC 




MOU R4.R 


2F0 


FB 




MOU fi.R3 


2F1 


RF 




MOU R7,R 


2F2 


27 




CLR fl 


2F3 


flfl 




MOU R2,R 


2F4 


IB 




iNC R3 


2F5 


F7 




RLC fl 


2F5 


EB 


F5 


DJH2 R3,$2F5 


2F8 


RB 




MOU R3,fl 


2Fg 


00 




MOP 


2FR 


00 




HOP 


2FB 


00 




HOP 


2FC 


00 




HOP 


2FB 


00 




NOP 


2FE 


D1 




XRL H,§R1 


2FF 


5B 




RHL R.R3 


300 


C& 


05 


JZ $305 


302 


BR 


80 


MOU R2.»$80 


M 


33 




RET 


W 


FC 




MOU fl.Fi4 


306 


95 


09 


JHZ $309 


30S 


S3 




RET 


309 


FB 




MOU R.F;3 


30Fi 


37 




CPL fl 


30B 


5E 




RHL fl.R6 


30C 


44 


E? 


JMP $2E7 



Ini t for counter- 
Save "changed" mask 
Don't shift any ones in 
Pop bits out to test for a logic 1 
Count b i t pos i t i on 
Loop until a 1 is found 
Save par t i a i resu 1 1 
Get counter 
Save i t too 

Load a blank workspace 
Ciecsr pushed/re leased flag 
Adjust for loop 

Shift the one back to where it imqs 
Loop for correct number of bits 
Save mask containing a single "change" 
Dai ay 
Delay 
De i ay 
De i ay 
De 1 ay 

Invert key status data 
Mask only for this key 
if it was just pushed down 
Load "released" mask 

Done (process release before any pushes) 
Oet partial shift result 
if mu 1 1 i p i e push , re 1 oop 
Done ("pushed") 
Get iTiask of changes 
Flip state 

Remove the first key found 
Re ! oop 



;Set CV if the $30 or $3R FIFO's contain data 

; This subroutine iiii I! test both of the FIFOs for 
;data. The carry flag ail! "oe cleared if both 
; FIFOs are empty. 

.» 

; En try Nona 

;Exit CV set if either had data 

:Use5 fl.F.BO 



30E 


97 


CLR C 


3CF 


B8 3R 


MOU R0.«$3fl 


311 


FO 


MOU R,g'R0 


312 


96 19 


JHZ $319 


314 


S8 30 


MOU R0,«$30 


316 


FO 


MOU R,?RO 



Init to assume both empty 

Load pointer 

Get first data byte from this FIFO 

i f some contents 

Load pointer 

Get first data byte from this FIFO 



317 


C5 ifl 


JZ $31fl 


:Exit i f j t mas amply 


319 


H? 


CPL C 


.;Flag some contents 


3 Ifl 




RET 


; Done 



3 IB 


54 


B6 


3 ID 


B8 


30 


3 IF 


FO 




320 


96 


24 


322 


BO 


7S 


324 


04 


55 



;Sind cjn "awake" code if r-so thing else to send 

.; This routine will check the keyboard FiFO for- data. 
;!f it is empty, it ujill place a "NUL" event code 
j there. In any case, it wi!! reset the idle tiiner 
;and go try to send the result <or data) to the Mac. 
;Th!s code is branched to from the command loop. 

; Entry Hone 

.;Exit" RO = $30 

; ($30) = $7B if ncthinq else in FIFO 

; <$2E) = $00 

jUses B,F,T,ai 

CALL $285 ;lnit timer and reset inactive counter 

MOU R0,«$30 ;Load pointer into FIFO 

MuU fljS'nO ;Get present Malue 

JNZ $324 ;!f somethinq already present - skip 

MOU SFiO,«$7B ;Load aiuake code 

JMP $055 ; Go send i t 



jKei-et keyboard 

; This short piece of code is executed from the command 
; processing loop in response to a keyboard /keypad 
; reset command. The result is always 03 and is set up 
;to fae sent out the serial port. 

; Entry None 

;Exi t" RO = $36 

; ($35) = $03 

; Uses .R i 1 , 8i2 



326 


54 


89 


CRLL $239 


32S 


BS 


35 


MOV RU,»$36 


32fl 


BO 


03 


MOU gR0,«$03 


32C 


04 


55 


JMP $055 



; Reset/ i n i t i a i i sa RRM 
; Load po i n ter to resu it "FIFO' 
jLoad return code saying 
; Go send i t 



;S021PRGE3 - Comments by The IM Underground ^O 1985 
; Transmit a data byte on P21 

; This rout ins ujiii send 8 bits out P21 lyhan supplied 
;with an external clock into P06. The msb will be sent 
; first. The code has seyaral time outs. If one of these 
; is reached., the transfer is aborted aith the ports iaft 
; however they luere last, initially, the routine lui I I 
jvjait for the clock input to be inactive - it can irait 
; forever for this, it yjill then set P21 low to act as a 
; "start" fait and the iijait up to about 204S cycles for the 
; first clock edge. On all following bits, it wili wait 
;up to about 8192 cycles per bit before timing out. The 
; output data oiiM change lyithin 8 to IS cqcles of the 
; fa! ling edge of the clock. The cloci< should be louj frcm 
; 10 to 22 cLfcies and the ma.ximum data rate is one bit 



■■>■■? 



every 22 cycies. 



is left at the last sent 



;data even during a time-out, the calling code should 
; reset i t to a 1 to allow future input. 



;Entrq fl = Data 
; ' P05 = P21 



•i t 



1 

.^'io timeout 
fi = R1 = $00 

DO = •tec 

I ^ -t'l r 

T i iTieou t 
a = $40 



-•Ul. 



unt of unsent bits 



iUses H,F,TF.RrR5,P2, 



.ai 



l§ 


RD 
00 




nOU R5,R 
NOP 


330 


54 


Efl 


CRLL $2Bfl 


332 


OS 




IN fl,PO 


333 


53 


40 


flNL fl,«$40 


335 


C& 


32 


JZ $332 


337 


23 


CO 


MOU fl,«$CO 


33y 


54 


B3 


CRLL $2BB 


33B 


B9 


OS 


MOU R1.«$n3 


330 


23 


FD 


MOU R,«$FO 


33F 


3R 




OUTL P2,fl 


340 


FD 




ilOy R,R5 


341 


F7 




RLC R 


342 


RD 




MOU R5,R 


343 


F5 


59 


JC $359 


345 


03 




IN R,PO 


346 


53 


40 


RHL fl,»$40 


343 


C6 


4E 


JZ $34E 


34fl 


15 


SB 


JTF $38B 


34C 


64 


45 


JrIP $345 


34E 


*L-^ 


FD 


nOU fl.«$FD 


350 


3fl 




OUTL P2,fl 


351 


27 




CLR fi 


352 


62 




r10U T,a 


353 


16 


55 


Jl^ $355 



jSave transmit data 

; De i ay 

; Reset timer 

;Get clocking input 

; flask for P05 

; Loop unt i ! i nac t i ve 

;Load new timer data 

;Set It in 

;Lcad data length 

;Load a "0" for P21 

;Sand start bit on P2 

;Get transmit data 

; Sh i f t over 

; Rep I ace resui t 

; Send a one b i t 



Get clock input 

Mask for clock input on P05 

Send the next bi t 

Error timeout 

Ua i t for f a i I i ng c I ock edge 

Load output data 

Send a "0" on P21 

Load a 

Reset the timer 

Reset timer flag 



to maKe up receiver 



•■■'55 no NOP 

356 E5 40 DJHZ R1,$340 



; Da i ay 

;Loop for ful 
;Done 



35fl 
35C 

350 
362 
354 
365 
366 
367 
369 
38fl 
3dC 



us 
53 

15 
64 

3fl 

62 
16 

GO 
E9 



40 

52 

SB 

59 
cc 



69 



40 



IN R.PO 
RNL R,a$-40 
JZ $352 
JTF :|;3SB 
jnP $359 
MOU fl,«$FF 
OUTL P2.fi 
CLR fl 
MOU T,R 
JTF $369 
HOP 

DJN2 R1,:|340 
RET 



.:Gel clocking input 

jMask for POo 

;Sand the next bi t 

; Error timeout 

; iia i t for f a 1 I i ng c i ock edge 

;Load output data 

;Set Q "1" on P2i 

;Load a 

; Reset timer 

j CI ear timer fiag 

; De I ay 

; Loop for f u i i 

iDone 



4te 



; Receive a data byte on P21 

; This routine mil] input a data bute from the P21 line. 
;The iTiSb will be read first, fi clocking input should be 
; provided on P0&. The coda here tuill sample the data 
; input within 6 to 16 CPU cycles of the falling edge of 
; the clock line. The data should not be sent faster than 
.; 1 bit every 20 CPU clock cycles. If the entire byte has 
;not been transferred within about 8192 CPU cycles' the 
; routine »ii I I abort t.he transfer. The clock input s.hould 
;be low for a iiiaximum of 19 cycles and a m i n i mum of 10. 

; Entry P0& = 1 

;Exit Ho timeout 

■ fl = R5 = Data 

; R1 = $00 

; Timeout 

.; fl = $40 

j R1 = Count of remainina un fetched bits 

; P2 = $FF 



rUses 






36D 


00 




NOP 


JoE 


54 


BR 


CRLL $2Bfl 


370 


RD 




MOU R5,fl 


371 


B9 


OS 


nou R1,»$0S 


373 


07 




DEC fl 


374 


'5P 




OUTL P2,fl 


375 


08 




IM R.PO 


375 


53 


40 


RNL R,»$40 


378 


C5 


7C 


JZ $37E 


37ft 


15 


8B 


JTF $3SB 


37C 


64 


75 


JMP ;|;3?5 


37E 


Cfl 




!H R,P2 


37F 


53 


02 


RNL fl,«$02 


3S1 


97 




CLR C 


332 


C6 


85 


JZ $385 


384 


fl7 




CPL C 



; Je 1 ay 

;C1 ear timer for a timeout 

; CI ear receive byte (fi = 00 > 

jLoad data length to receive 

jLoad an $FF for output data 

;Set outputs inactive 

;Test the clock input 

;Mask for P06 

;Get the bit if the clock uient low 

; Error timeout if timer times out 

; Re loop until timeout or full byte 

; Input data from source 

;Mask for P21 

;Gat ready for shift 

;«ake CV = P21 

; Switch state to a '1' 



385 


FD 




MOU a,R5 


386 


F7 




RLC fl 


337 


ftD 




MOU R5.fi 


ft 


00 




NOP 


^re 


E9 


75 


DJNZ R1,$375 


39B 


93 




RET 



38C 


B9 




nOU R1,«$08 


3SE 


FO 




nou fl,§Ro 


38F 


RB 




HOy R3,fl 


390 


F7 




RLC fl 


391 


m 




nOU R3.fl 


392 


F6 


B9 


JC $389 



394 


23 FE 


MOU R.«$FE 


396 


3R 


OUTL P2.fl 


397 


23 7F 


nou a,«$7F 


399 


90 


OUTL PO,fl 


39fl 


BC 01 


MOU R4.*$01 


390 


54 F!3 


CRLL $2a3 


39E 


CO 


HOP 


39F 


00 


HOP 



;Get recaiva shift ragister 

jShi ft in nei.i.i data 

; Rep i ace resu i t 

; De I ay 

; Fetch full byta 

: Don« 



; Transmit a byta on P20 from a FIFO 

; This routine wi i i sand 8 bits of dates that vsQr-i 
j stored in a FIFO out the P2n i /o line, fl clock is 
; provided out P07 to clock the data. The msb will be 
;sent first. Assuming no hardware en-ors, the Isb of 
;the data sent «>i I I end up being a '1'. this routine 
;ujili lake 286 CPU cycles to axscuta including the CRLL 
; to get here) when the Isb of the data sent is a '1' 
;arid the data sent was the only entry in the FIFO. 
;Tha clock will be low 15 cycles and high 17 cycles and 
; the data out tuili change 4 cycles before the falling 
.; clock edge. Once the data byta has been sent, tha FIFO 
.; is moved doi^n one byte luith t.he vacated position fi I led 
: •.!■! i th a . The command f I ag i s a I so c I eared - thus 
; turning off uihateMsr cominand caused this data byte to 
;be sent. 

j Hs luritten, the FIFO handling has two bugs, if the 
;FiFO contained 5 bytes of data, the last byte will 
; never get cleared, it will replicate itself forever 
jiiiuch like the sign bit in an RSR operation. Riso, in 
;this situation, the command byte ujill not get cleared 
;but rather the last data byte miii also rep I ice? ta 
; i tse 1 f there . 

; Entry RO = Start of FIFO to take data from 
;txit R = i;2F> = 
; RO = 2F 
; R4 = 00 

PO = P2 = FF 
jUses R,F,R0,R1,R3,R4,P0,P2,Si1 

;Load number of bits to send 

;Get a data byte from the FIFO 

j Save it in R3 

jTest the present msb 

;Save rotating result for next loop 

; Transm i t a I og i c one i f o ' 1 ' 

; Transm it a I og i c zero 

;Load port data 

;Set P20 to a logic 

;Load clocking data 

;Get clock ready 

;Load delay count 

; Dei ay total of 8 CPU cycles 

; Da I ay 

; De i ay 



3fl0 


23 


FF 


nOU fl,«$FF 


3fl2 


90 




OUTL PO.R 


3fi3 


FB 




MOU fl,R3 


m 


00 




NOP 


W 


00 




MOP 


3fl6 


E9 


90 


DJNZ R1.$390 



;Load ciccking data 

j Clock data in at destination 

;Get remaining data to send 

; De ! ay 

; Del ay 

jLoop for rest of the bits 



;i1ovs the FIFO down one byte 



3flS 


BC 


04 


MOU R4,»$04 ; 


Sflfl 


F8 




nOU fl.RO ; 


3BB 


17 




INC fi : 


3flC 


fig 




nou Ri.n ; 


3RD 


F1 




riOU fl.gRI ; 


3RE 


ao 




nou §RO.R ; 


3aF 


C6 


B5 


JZ $3B5' ; 


3B1 


18 




INC RO ; 


3B2 


19 




INC R1 ■; 


3B3 


EC 


m 


DJNZ R4,$3aD ; 


3B5 


B3 


2F 


tlOU R0,»$2F : 


3B7 


m 




MOU gRO.fl ■; 


3B8 


83 




RET ; 



Load rrsax size ffiovs *** BUG *** 

Get destination pointer 

fidvance i t 1 

Set source just aboye destination 

Get a byte 

riove it down one FIFO entry 

E>d t if and of data 

Rdvance destination pointer 

Hduance source pointer 

Loop for up to 4 bytes of data in FIFO 

Load pointer to command byte 
jRtteiTipt to clear it *** BUG *** 
; Done 



; ! ransm it a ! og i c one 



339 
3BB 
SBC 
3BE 
3BF 

i 

3C5 
3C7 
3CS 
3C9 
SCR 
3CB 
3CD 



3R 

23 7F 
90 

BC 01 
54 R3 
00 
00 

23 FF 
90 
FB 
00 
00 

E9 90 
64 flS 



nou a.«$FF 


;Load port data 


OUTL P2.fl 


;Sat P20 to a " 1" 


MOU fl,«i7F 


.;Load ciockinq data 


OUTL PO,fi 


:Get clock output ready 


MOU R4.«$01 


;Load delay count 


CRLL $2R3 


; Dei ay total of 3 CPU cycles 


NOP 


; De 1 ay 


NOP 


;Daiay 


MOU R,«$FF 


.iLoad clocking data 


OUTL PO,R 


jClock data in at destination 


MOU H,F!3 


;Get remaining data to send 


NOP 


.; De ! ay 


NOP 


; De ! ay 


DJNZ R1,$390 


.;Loop for rest of bits 


JMP $3fl8 


jGo to FIFO moua 



jFlaceiya a data byte from F20 

.: This routine will read 8 bits of serial data from the 
;P20 I/O line. It will supply a data clock out the PCi7 
.; output to clock data out of the source. The irssb is 
; transferred first. The data read uiili be left in the fl 
; register Qr>d also placed in the active command flag. 
;Thus any commands received mi i I automatical ly be set as 
; the current command to execute. The Isb of all received 
;data i.ui ! I be pitched so that it can be used as a stop 
jfiag by the sender. This routine will take 333 CPU cycles 
j to execute (including the CALL to get here). The clock 
;is loiM for 18 cycles and high for 22. The data will be 
; samp lad 8 CPU cycles after the rising edge of the ciock. 



.;tntry P20 = P07 = t 

.:Exit" fl = <2F> = Data RHD FE 

; RO = 2F 

: R1 = R4 = 00 

.; R3 = Data 

.; PO = FF 

;Usss R,F,R0,R1,B3,P.4,F0,S1 

3CF BR 00 MOU R3,»$00 ;Clear receive register 

301 B9 OS MOU R1,*$08 jLoad lenqth in bits to raceivs 

3D3 23 7F MOU fl,»$7F ;Load clocking data 

305 90 OUTL PO.fi ;Set PO? toMj to clock out next bit 

3D6 BC 02 nou R4,«$02 ;Load delay count 

308 54 fl3 CRLL $2R3 -Delay total of 12 CPU cycles 

3Da 23 FF mki fi,»$FF jLoad'c locking data 

3DC 90 OUTL PO,F! ;Set P07 high or- inactiue 

3DD Ffi MOU a,R3 ;Get serin! shift register 

3Dt t7 RL fi jMoye present data over one bit 

3DF flfl nou R3,R ;Save result for later OR with new 

3E0 00 NOP ; Del ay 

3E1 00 r-^OP ; Delay 

3E2 00 HOP -Delay 

3E3 Oa m fl,P2 .;Get input data fro;!! P20 

3E4 53 01 RHL fi,«$01 jMask for oniy sariai input in DO 

3E6 4fl ORL fi,R3 ; Combine with previously read bits 

3E7 HH MQU R3,a ; Replace result for next time 

3ES 00 NOP ;DaiaM 

3E9 00 NOP ; Dei ay 

3ER 00 mP ; Del ay 

3EB 00 NOP ; Del ay 

SEC E9 03 DJMZ R1,$3D3 ; Loop "for a complete byte of data 

i3 FE RHL H,*$FE jMask out isb >;stop bit) of input data 

B8 2F MOU R0,,«$2F ;Load pointer to command flag 

3F2 RO nou §RO,R ;Save input data with !sb=0 there 

3Fj S3 RET :Done 



;Use up waste space to full IK 
DCS $FF^ 12 ; Empty space 
END 



Keyboard MPU register uscsge - The IM Underground (c> 1985 



Reg. Keyboard L4saga 



ffo7 



08- 


•17 


18- 


■IF 


20- 


•24 


25- 


•29 


2fl 




7P. 





2D 



30-34 

35 
36 



33-39 
3F 



General purpose registers 

8 levei processor stack 

Unused 

Key status table <0 = pushed) 

Rest of keu status tab!e 

Unused 

Unused 

V-Jeypad f'ag byte. Left at to 

disable some keypad ioop flags. 
DO = Set to flag keypad mode 
D1 = Prouides diuids by 2 for 

idie timer (keyboard absent) 
D2 = Set when keypad prefix sent 
D3 = Set to a one disable 2-key 

roll oyer (a I ways zero) 
D4-D& = Unused - left at zero 
07 = Set i f keyboard absent 

Unused 

Idle timer. LJhan it reaches 2, 

C3 data byte is sent to the hac. 

Reset fflhen data is sent. Counts 

i.uhen the timer tinses out. 

ComiTiand flag, received cornmands 

are placed here for processing. 

After they are executed, the 

location is cleared. 

10 = Permission to send 1 byte 

14 = Request for data 

15 = Perform a reset 
36 = Perform self test 

Else = NOP 

Keyboard FIFO. Data is placed 

in the first zero location and 

taken out of location 30. 

Zero to a 1 i cm the above F i FO 

to empty. 

Single byte FIFO for passing 

responses back . 

Zero to clear the above 

Unused 

Unused 

Unused 



Keypad usage 

General purpose registers 

S level processor stack 

Unused 

Key status table <0 = pushed) 

Unused 

Unused 

Counts loops if keyboard is 

not responding (absent). 

Keypad flag. See at left for 

uses of the various bits. 



Unused 

Idle timer. Every 2S loops (56 

if keyboard absent) of idie time 

a data byte uui I ! be sent to the 

Mac . 

CoiTimand flag, received commands 

are placed here for processing. 

After they are executed, the 

location is cleared. 

10 = Permission to send 1 byte 

14 = Request for data 

16 = Reset keyboard and self 

36 = Self test on keypad 

75 = Self test on keyboard 

Else = HOP 

FIFO of data read from the 

keyboard. The operation is 

identical to the keyboard mode. 

Zero to a I ioiu the above FIFO 

to empty. 

Single byte FIFO for passing 

responses back. 

Zero to clear the above 

Unused 

Keypad FIFO. Operates similar 

to the other FIFOs. 

Zero to clear the above 



Port Keyboard usage 

00-02 Scan return 1 ines 

03-04 Scan return I ines 

05 Scan return I ine 

06 Status of CAPS LOCK 

07 Clocking output to Mac or keypad 



Keypad usage 

Scan output I ines 
rk<n multiplexed key status 
Tied low to select keypad mode 
Clocking input from keyboard 
Clocking output to Mac 



10-1? Scan output i inas 

20 Seriai I/O to Mac 

21 Scan output ! ine 
Status of SHIFT 
Status of CTRL 

T1 Status of OPT i OH 



Hon mui tJDi exad ksu status 



keupad 



ber i a i 



! /!"! 



llQC 



Ser i a 1 i / to keyboard 
Scan return ' ins 
Scan return ! ine 
Scan return I ine 



/ 

1 2 



Horizontal video active 

/\ 



/ 



U 

e a 

r V c 

I i 1 

i d I 

c e V 

a o e 




1 
2 



< 



U 
e 
r 
I 
i 

c 
a 
I 



341 

^ 342 

343 



< 



\ 



366 
367 
368 
369 
370 



13 



!' 






Mm 



llllll l 



»4 
i nfill ! 



ii um i —— — H i n t 



lllllll 



MM! 






>>5-^? 



■ f: 






w^ 



NNtf 






^P5 
^ 



m 



m 



m 



i 



M 



» 



i 

ii 



■wfi 



^■'. 



i j^ iii i 






m 



m. 



tm 



m — 

a. 



61 



— \y — 

63 64 65 



Hor i zon ta I re trace 
/\ 



67 



'y 









)i^ 



wn 



HUH ■ 



^K 



-HJ 



85 



\ 

87 88 



i 



i 



v*^ 



Each square represents one memory cycle - the use of each cycle is as follows: 
I I CPU access 






Uideo access 



Sound/disk speed 



m 



m 



Iki Iffl lM!arp®M[5! 
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NUL 
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STX 
ETX 
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ENO 
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BS 

HT 

LF 

UT 

FF 

CR 

SO 
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ETB 
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EH QOO 11001 
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00000000 

0000000 1 

000000 10 

OOGOO0 1 1 

00000100 

00000101 

000001 10 
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0000 1000 
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00001100 

00001101 
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00010000 
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00011110 

G0011111 
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OR 

OB 

OC 

OD 

OE 

OF 

10 

11 
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15 
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051 
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057 
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075 
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2E 

2F 
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33 

34 

35 

36 

37 

38 

39 

3fl 

3B 

3C 

30 

3E 



fiUL - nui f <zero> 

SOH - start of heading 

STX - start of text 

ETX - end of text 

EOT - end of transmission 

ENQ - enquiry 

BCK - acknoujiedqe 

BEL - bell 

BS - backspace 

HT - horizontal tab 

LF - i ina feed 

UT - yertica! tab 

FF - form feed 

CR - carriage return 

SO - shift out 

Si - shift in 

DLE - data i ink escape 

DC1 - deuica control 1 

DC2 - device control 2 

DCS - device control 3 

BC4 - device control 4 

HhK - r&qative acknowledqe 

S'/M - synchronous idle 

ETB - end of transmit block 

CfiH - cancel 

tH - :anc of medium 

SUB - substi tuta 

ESC - escape 

FS -file separator 

group separator 

record separator 

uni t separator 

space 
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01000000 

01000001 

01000010 

01000011 

01000100 

01000101 

01000110 

01000111 

01001000 

01001001 

01001010 

01001011 

01001 ICO 

01001101 

01001110 

01001111 

01010000 

01010001 

01010010 

01010011 

01010100 

01010101 

01010110 

01010111 

10 1 1000 

01011001 

01011010 

01011011 

01011100 

01011101 

01011110 

01011111 

1 100000 

01100001 

01100010 

01100011 

01100100 

01100101 

01100110 

01100111 

01101000 

01101001 

01101010 

01101011 

01101100 

01101101 

01101110 

01101111 

1 1 10000 

oil loco 1 

01110010 
01110011 
01110100 
01110101 
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01110111 
01111000 
01111001 
01111010 
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01111100 
01111101 
01111110 
01111111 
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120 
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170 12 
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174 
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53 

64 

65 

56 

57 

68 

59 
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5B 
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The System Revealed 

The Standard System File (05/02/84) contains both a resource and data 
fork. The data fork is loaded upon boot-time (system start-up) and installs 
various ROM patches — the install entry point is located 512 bytes into the 
fork. The resource fork of the file is where most of the action takes place, 
it contains 26 individual resource types: 

ALRT (Alert template) 

4 resources - Used by the SFPackage (3) - each has the [Purgeable] bit set. 

-3994 ( 1 2 bytes) : "Can't find that disk." 

-3995 (12 bytes) : "A system error occurred; please try again." 

-3996 (12 bytes) : "Replace existina '"■O" '"'" 

-3997 (12 bytes) ; "Disk is locked."" 

BNDL (Bundle) 

1 resource 

(40 bytes) : Links System File with FREF & its icon. 

CDEF (Control definition function) 

2 resources - each has the [Purgeable] bit set. 

(0566 bytes) : Object code for various button definitions. 

1 (1268 bytes) ; Object code for scroll bars definitions. 

CURS (Cursor - cursor, mask, .5-. hot-spot) 
4 resources 



1 (66 bytes) 

2 (68 bytes) 

3 (68 bytes) 

4 (68 butes) 



i-Beam cursor 
Cross cursor 
Plus cursor 
'Watch cursor 



DITL (item list in a dialog or alert) 

6 resources - Used by the SFPackage (3) - each has the [Purgeable] bit set. 

-3994 (058 bytes) : "Can't find that disk." 

-3995 (078 bytes) : "A system error occurred; please try again." 

-3995 (074 bytes) ; "Replace existing ""0" 7" 

-3997 (052 bytes) : "Disk is locked." 

-3999 ( 1 44 bytes) : "Save as:" 

-4000 ( 1 66 bytes) : "Open" 
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DITL cont'd. 

I resource - Used by Disklnit package (2) - has the [Furqeaoiej bit set. 
-6047 (422 bytes) : "Initialize this disk?" 

1 resource - Used by Key Caps - has the [Purgeable] bit set. 

-15936 (030 bytes) ; Key Caps dialog item list 

0L06 (Dialog template) 

2 resources - Used by the SFPackage (3) - each has the [Purgeablej bit set. 

-3999 (23 bytes) : "Save as:" - used in SFPutFile 

-4000 (23 bytes) : "Open" - used in SFi3etFile 
1 resource - Used by Disklnit package (2) - has the [Purgeable] bit set. 

-604? (23 bytes) : Disklnit dialog box 
1 resource - Used by Key Caps - has the [Purgeablej bit set. 

-15936 (29 bytes) : Key Caps dialog box 

DRVR (Desk accessory or other device driver) 
8 resources - each has the [Purgeablej bit set. 

2 (1024 bytes) : ".Print" - Handles irnageWriter printing 

12 (2444 bytes) : "Calculator" 

13 (3392 bytes) : "Alarm Clock" 

14 (1 586 bytes) ; "Key Caps" 

15 (0932 bytes) ; "Puzzle" 
15 (2418 bytes): "Note Pad" 

1 7 (2824 bytes) : "Scrapbook" 

18 (4038 bytes) : "Control Panel" 

DSAT (Sy^itern startup alert table) 

1 resource - [Locked! and [System Heapj bits set. 

(482 bytes) : Dialog information for system start-up. 

FKEY (Cornmand-Shift-Nurnber routine) 

2 resources - each has the [Purgeabls] bit set. 

3 (312 bytes) : Code for screen snapshot to disk. 

4 (094 bytes) : Code for screen dump to printer. 

FONT (Font) 

27 resources - each has the [Purgeable] bit set except (Chicago- 12). 

(0000 bytes) : "Chicago" font reference number. 

1 2 (2940 bytes) : (Chicago- 1 2) [System Heap] bit set. 

256 (0000 bytes) : "New Vork" font reference number. 
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FONT cont'd. 
265 
266 
258 
270 
274 
276 
280 
384 
393 
394 
396 
398 
402 
404 
408 
512 
521 
524 
640 
654 
768 
786 
896 
914 



(2032 
(2200 
(2734 
(3352 
(4516 
(5260 
(6832 
(0000 
(2 1 52 
(2200 
(2734 
(3568 
(4864 
(5848 
(7568 
(0000 
(2026 
(2464 
(0000 
(3604 
(0000 
(3268 



(4466 



bytes) 
bytes) 
bytes) 
bytes) 
bytes) 
bytes) 
bytes) 
bytes) 
bytes) 
bytes) 
bytes) 
bytes) 
bytes) 
bytes) 
bytes) 
bytes) 
bytes) 
bytes) 
bytes) 
bytes) 
bytes) 
bytes) 
bytes) 
bytes) 



(New Vork-9) 

(New York- 10) 

(New York- 1 2) 

(New York- 1 4) 

(New York- 1 8) 

(New York-20) 

(New York-24) 

"ijeneva" font reference number. 

(Geneva-9) 

(Geneva- 10) 

(Geneva- 12) 

(Geneva- 1 4) 

(Geneva- 1 8) 

(Geneva-20) 

(6eneva-24) 

"nonaco" font reference number. 

(f1onaco-9) 

(Monaco- 12) 

"Venice" font reference number. 

(Venice- 14) 

"London" font reference number. 

(London- 18) 

"Athens" font reference number. 

(Athens- 18) 



FREF (File reference) 
4 resources 

(13 bytes) 

1 (13 bytes) 

2 (18 bytes) 

3 (21 bytes) 



"System" - system file name. 
"Finder" - finder file name (start-up application) 
"IrnageWriter" - print driver file name. 
"Clipboard File" - clipboard file name. 



FRSV (Font reserved for system use) 



1 resource 



1 



(10 bytes) : Hmrnm'?... 



ICN* (Icon list - icon & mask) 
1 resource 

3 (256 bytes) : System File application icon 
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ICON (Icon) 

4 resources - each hos the [Purgeoble] bit set. 

(128 bytes) : Alert face with "i" 

1 ( 1 28 bytes) ; Aiert face with "*" 

2 (128 bytes) : Alert face with "?" 
-604? (128 bytes) ; Diskinit icon for DiTL -6047 

IN!T (initialization resource) 

3 resources - each has the [Locked] and [System Heap] bits set. 



(646 bytes) 

1 (100 bytes) 

2 (768 bytes) 



Keyboard software map 

Keypad software map 

Dialog information for system "bomb-bG?<^ 



INTL (International resource) 

2 resources - each has the [Purgeable] bit set. 

(032 bytes) : International format settings (time, date, etc..) 

1 (332 bytes) ; international date names (days, months, etc..) 



HACS (Program information) 
5source 
(13 bytes) : "Mac Software " 



I resource 



MDEF (Menu definition procedure) 
1 resource 

(684 bytes) : Code standard menus. 

PACK (Package) 

6 resources - each has the [Purgeable] bit set. 

2 (2430 bytes) : DiskinitPackage - [Locked] bit also set. 

3 (3238 bytes) : SFPackage - [Locked] bit also set. 

4 (4540 bytes) ; Floating Point package 

5 (4190 bytes) : Tnanscendental functions package 

5 (1436 bytes) : International Utilities - [Locked] bit also set. 

7 (0208 bytes) : Binary-Decimal Conversion 

PAT (Pattern - a space is required after the T') 
2 resources 

16 (8 bytes) : Desktop pattern - [System Heap] bit set. 

1 7 (8 bytes) ; Scrollbar pattern 






PAT* (Pattern list - as seen in tfie Control Panel & MocPaint) 
1 resource - has the [Purgeable] bit set. 
(306 bytes) : ZS patterns 

PICT (Picture) 

8 resources - each has the [Purgeable] bit set. 

-15800 (477 bytes) : Centre] panel item - caret blink rate 
-15801 (097 bytes) ; Control panel item - volume slider 
-15803 (877 bytes) ; Control panel item - keyboard rates 
-15804 (698 bytes) : Control panel item - mouse button rate 
-15805 (383 bytes) : Control panel item - cursor scaling rate 
-15806 (917 bytes) : Control pi3nel item - volume scale 
-15807 (474 bytes) ; Control panel item - menu item flash rate 
-15968 (616 bytes) ; Alarm clock items 

PREC (Print record) 
! resource 

2 (72 bytes) : Retains current print settings. 

STR (.String - a space is required after the 'R') 

4 resources - each has the [Purqeable] bit set except -15871. 



(22 bytes) 

-8192 (12 bytes) 
-15871 (80 bytes) 



"Version 1.1 24-Apr-84" - system version number 
"I mage Writer" - print driver file name. 
"The Note Pad is unavailable unless there are 2K 
free bytes on the startup disk." 
-15872 (14 bytes) : "Note Pad File" - note pad file name. 



STR* (String list) 

1 resource - has the [Purgeable] bit set. 

-15840 (285 bytes) : 7 Scrapbook messages 

WDEF (Window definition function) 

2 resources - [Purgeable] bit set for WDEF 1. 

(1200 bytes) : Object code for square-cornered windows. 

1 (0838 bytes) ; Object code for rounded-cornered windows. 
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standard System File Data 

Version Date 05/02/84 

Resource Fork 127488 bytes 

Data Fork 5120 bytes 

Type ZSYS 

Creator MACS 

File Attributes Bundle S<. Inited ($2 1 ) 

File Flags $80 (not protected) 
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The Smoll System 



The Standard System File (05/02/64) can be significantly reduced in 
size. The following may be removed and the Finder and MDS Edit will still 
function: 

CURS - The thin-cross cursor (*2) may be removed if the Alarm Clock 
DRVR is also removed. The Wide-cross cursor i*5) may be removed. 

DHL - The Key Caps dialog item list (*- 15936) may be removed if the 
Key Caps DRVR is also removed. 

DL06 - The Key Caps dialog template (*-l5936) may be removed if the 
Key Caps DRVR is also removed. 

DRVR - The .Print driver (*2) rnay be removed if both the ImageV/riter 
file and the FKEV *4 resource are removed and no printing is to be done, if 
any hidden drivers (those whose names begin with a period) are left, at 
least one visible desk accessory must also be left or the Finder will crash. 
Note that many system resources may be removed if certain of these drivers 
are removed. 

FKEV - Either or both of these resources (*3 and *4) may be removed if 
screen snapshots are not needed. 

FONT - Almost all fonts may be removed. Don't remove a font name 
resource without removing all of it's actual fonts sizes too. Leave at least 
the Chicago- 12 font since a font is required by the system. 

INIT - The keyboard mapping function (*0) may be removed if both the 
keyboard and Key Caps accessory will not be used. The keypad mapping 
function (*1) may be removed if the keypad is not present or will not be 
used. 

PACK - Both the Floating Point package (*4) and Transcendental 
Functions package (*5) may be removed if the Calculator accessory is 
removed. 
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PAT* - The pattern list (*0) rney be removed if the Control Panel 
accessory is removed m\6 MacPaint SYon't be used with this System. 

PICT - The Alarm Clock pictures (*- 15968) may be removed if the the 
Alarm Clock DRVR is removed. The remaining pictures (*- 15807 through 
*- 15800) may be removed if the Control Panel DRVR is removed. 

PREC - The printer record (*2) may be removed if the .Print driver is 
removed. 

STR - The system version number string (*0) may be removed. The 
irnageWriter file name string (*-8192) may be removed if the irnaqeV/riter 
file is removed. The Note Pad strings (*- 15871 and *- 15672) may be 
removed if the Note Pad accessory is removed. 

STR* - The ScrapBook strings (*- 15840) may be removed if the 
ScrapBook accessory is removed. 

WDEF - The round cornered window definition function may be removed 
if the Calculator accessory is removed and no applications on the disk use 
this type of window. 

The following resources are all used to build the DeskTop file. Once this 
has been constructed, these resources may be removed. However, if the 
desktop needs to be rebuilt, the system icons won't appear. The Finder will 
also pause for a very long time before opening the disk's window. All of 
these resources should be deleted at once: BNDL *0, FREF *0 through *3, 
!CN* *3, and MACS *0. 
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Resource Flags 

This document describes the effects of the various resources flags 
listed in The System Revealed. 

Any resource with the su stern hea p flag set mU be loaded into the 
system heap instead of the application heap. This means that these 
resources will be available even when the application heap is not usable, 
such as during a program launch or system boot. A constructive use of this 
flag will be mentioned in the latter half of this document. 

Since the INiT and DSAT resources supply code and data that is important 
to the system's operation, these all must load to the system heap, in 
operation, these resources are detached from the System file once theu are 
loaded. This allows them to stay in memory even when the system resource 
file is closed (such as when the startup disk is changed). 

Two other resources load to the system heap - the desktop pattern and 
the system font. The Chicago- 12 font must load there since it is used in 
system bomb and disk switch alerts - which may occur at any time. The 
desk pattern is placed into the system heap as it is needed at the start of 
every program ¥/hen the Window Manager is initialized. !f it were not in 
memory at this time, a disk switch might be needed before the screen was 
cleared. 

The preload flag does not have much usefulness in the System file. In 
fact, it is generally ignored for system resources during boot time. Also, if 
the System file is opened by a resource editor, many unneeded resources 
might be preloaded into memory. 

Only a few resources use the locked flag. As several low memory 
pointers reference the iNIT end DSAT resources, they need to be locked once 
in memory. Several of the packages also have the locked bit set. There is no 
particular reason for this as they will be locked upon being called and 
unlocked when the package code terminates. 

The pur g eable bit by far has the most varied usage, it's use can 
profoundly affect system performance when memory space is low. Items 
that should not be purgeable are those that are needed almost continually by 
an application. Hence MDEF 0, WDEF 0, and the various CURS resources are 
not purgeable. If these were purged at the wrong time, the system would 
iust have to purge something else and reread these resources back into 
memory. Also, a heap's grow zone function might be able to make space at 
very little cost but this does not happen until all purgeable memory blocks 
have been removed. 
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Items that should be purgeable are those that are used only occasionally 
such as the disk initialization and standard file package dialog resources. 
Resources that are used vvith desk accessories should also be purgeable so 
that an application need not be permanently burdened with the remains of a 
desk accessory after it has been closed. Hence all of the ALRT, DiTL, DL06, 
DRVR, PiCT, and FONT (except Chicago- 12) resources are purgeable. The 
WDEF 1 resource is also purgeable since it is mainly used in some desk 
accessories. The Note Pad message STR -15871 is flagged as not purgeable. 
This is probably a mistake and should be changed to being purgeable. 



The Fast System 

By careful use of the system heap flag, a System file that is only used on 
512K (or more) computers can be changed to provide a noticeable soeed ud. 
This involves having the commionly used resources load into the system neap 
instead of the application heap. Thus when a new application launches, 
many of the resources that it needs will already be in memory - bypassing 
the delay in reading them from a disk. 

There are several disadvantages to this: Some programs modify a 
resource (in memory) for their own use. Since normially any subsequent 
program would get a new version of the resource, the resource is not 
changed back. However, when it is in the system heap, the old m!0dified copy 
will be used by the following program. An example of this is the Fedit 
program - it changes the date format in the INTL resources. Another 
disadvantage to placing resources in the system heap is that the disk will 
not be usable on a 128K computer. The last disadvantage is that the Finder 
will occasionally purge the wrong data from memory - leaving a rather odd 
looking (but still functional) desktop - i.e., there is a bug someplace. 

Since there is not enough space to hold every resource, the greatest 
benefit can be gained by placing only the most used ones into the system 
heap. Essentially, this amounts to those that dre left after every step 
mentioned in The Small System has been performed. A few others may be 
placed into the system heap - such as a font or accessory that is used often. 
(Note that the Finder uses the Geneva-9 font.) Don't set any flags for any of 
the BNDL, FREF, ICN*, and MACS resources as these are only used by the 
Finder to build the DeskTop file. The following is a working list of all the 
resources that load to the system heap from an extremely cut down System 
file: (The only other resources in this file are the Finder resources 
mentioned above.) 
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• ALRT -3997 to -3994 

• CDEF and 1 

• CURS 1 to 4 

a D!TL -6047, and -4000 to -3994 

• DL06 -6047, -4000, and -3999 

• DSAT 

• iCON -6047, and through 2 

• INiT and 2 

• INTL and 1 
a MDEF 

• PACK 2, 5, 6, and 7 

• PAT 1 6 and 17 

• WDEFO 

• The FONTS ChicsQO-12, 6eneva-9, and f1onaco-9. 

There are two ways to change all the the resource flags. The easiest is 
to use the Resource Editor program and simply open the System file and 
change the needed flags, if this is not available, then the RMover and Fedit 
programs can be used to accomplish the same result by following the 
following steps: 

• Use the Finder to duplicate the System file on the target disk. (Use a 
disk without any important data on it. The disk also must have RMover on it 
and should have Fedit available.) 

• After the Finder finishes, reset and reboot the system from this sarns 
disk. (Either by pushing the reset button or turning the computer off and 
then back on.) This is needed so that the new file can be renamed. 

• Rename the copy of the System file to a 6 character long name. 
Sgsten is a good choice. 

• Using Fedit, Open the copy and get to the resource fork. Scan to near 
the end until the resource type names in the resource map become visible. 
Mow change all of them to something the system won't recognize but that 
can be easily changed back later. The best choice would be to simply change 
the letters to lower case. The Resource Manager NYill consider these as 
different resources but their true name will still be distinguishable. Note 
that the ICN*, BNDL, FREE, and MACS names can be ignored as these won't be 
touched later. 
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• Now use RMover (it must be run from the startup disk - sYhich should 
be same one that contains the duplicate System file) and Open the copy. 
Select ol] of the resources to place into the sustem heop ond select Open 

from the menu. A diaicg boK should appear that contains a check box marked 
System Heap. Click it so that it is selected. For the fonts, don't bother with 
the resources that simply define the font name (these S¥ill be bytes long). 

• Run Fedit again and change the resource type names back to their 
originals. (The entire reason for changing the names in the first place is so 
that the system won't get confused between the real System file and the one 
being modified.) 

• The following step requires that some File Manager data be modified 
while the system is running and has one of the files in question open. 
.Perform this step to completion all at one time. Use Open Volume in Fedit 
to open the startup volume (this is where all the above changes have been 
made). Scan along several sectors until the volume directory (which begins 
in sector number 4. Find the file name System and use ASCII -modify to 
change it to something else. (Systen is fine.) Now look for the name of the 
copy of the system (Systen if the original suggestion was followed) and 
use ASCII -modify to change it to be System (this is the reason for making 
it 6 characters long). Make sure to use the Write command to write each of 
these changes to disk. This entire step is needed to replace the original 
system file with the modified copy. 

• Now immediately reset and reboot the system (don't even e^it the 
Fedit!). if this is not done immediately, the system might write some of the 
old directory back or even worse - crash. 

a The system should now boot up normally. As time goes on, it should 
speed up somewhat. If the debugger program MacsBug is available, use the 
HX and HD commands to examine the resources currently in the system heap. 

The above steps should result in faster operation of the computer, it is 
recommended that disks with important data not be modified in this way. 
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512K Upgrade 

This document describes the procedure to upgrade a 128K nacintosh to 
512K. This operation should only be attempted by those with considerable 
skill with soldering tools and integrated circuits. It will also void Apple's 
warranty and Apple Care. Finally, there is the possibility that after-market 
hardware enhancements will be incompatible. (The iM Underground cannot 
assume any responsibility for problems caused by this procedure.) 

In principle, the upgnade involves removing the present 64K RAMs, 
installing new 256K parts and adding an extra multiplexer chip along with 
some discrete components. The parts needed are: 

• Sixteen 256K bit RAM chips @200nS or faster (41256-200). 
9 A 74AS253 or 74F253 multiplexer. 

• Two 2.2KQ resistors, 
s One 47'w' resistor. 

9 One.1 uF capacitor (preferably glass). 

» 16 pin sockets for the above mentioned circuits. 
The follosYing tools and supplies will be needed during the upgrade: 

• A Torx T- 1 5 screwdriver. 

• Desoidering tools. 

• A soldering iron with a small tip. 

• A tool to help in removing and inserting chips from sockets. 

• Diagonal cutters to clip excess lead length. 

• Solder. 

• Fine wire - such as wire- wrapping wire. 

Even though sockets are not absolutely required, installing them is 
recommended because the desoidering process can weaken the traces on the 
circuit board. The first time they probably won't come off if care is taken. 
However, the second time that a chip is removed, the traces might easily 
come off. This would need to be done if one of the new RAM chips is 
defective. 

Precautions against static damage should be observed during the entire 
upgrade procedure. If an anti -static workstation is not available, covering a 
desktop with aluminum foil should suffice. If foil is used, be careful not to 
short any live circuits to it. Avoid walking over a carpet and then directly 
touching any circuitry, it is advisable to remain seated at the work area 
until the entire upgrade is finished. If available, use a soldering iron s-\'1th a 
grounded tip. 

The first step in any upgrade is opening the Macintosh case. Start by 
disconnecting all cables and accessories. Also remove the programmer's 
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switxh if It is installed. This can be done by prying it up using a smaj] 
screwdriver. Now place the Macintosh face down on a smooth surface. 
Using the Torx screwdriver, remove the 5 screws holding the case on. Ivm 
are located at the bottom of the back near all of the connectors. These go 
into metal and thus will be hard to twist at first. (!f a screwdriver other 
than the Ton^ is used, the heads of these screws will be simply stripped - 
making it almost impossible to open the case.) Another screw is located 
inside the battery compartment while the last two screws are at the top 
under the carrying handle. Ail of these go into plastic - it may be possible 
to use a standard flat head screwdriver to remove these. Nosy pull the back 
of the case off. This is an eKtremely tight friction fit and will require that 
the top and bottom be gently worked loose. Do not use a scresvdriver to 
"lever" it open - this will only gouge the plastic. Eventually, the case will 
literally pop off. Slide it up and off carefully so as not to scratch the inside 
which is coated with conductive paint. Once the case is opened, remove the 
foil shield from the connectors. Next unplug the 20 wire ribbon cable going 
to the disk drive and the 10 wire power connector. Now grab the logic boa.ra 
by the small metal frame on it and slide it out of the chassis. 

The next step is removing the present memory chips. These are all 
located in the box marked "RAM" at the front of the circuit board. The grid 
coordinates are F5 through FI2 and i35 through G12. These parts should be 
marked either with the number 4164 or something close, if a desoldering 
station is to be used, desolder each pin of each RAM and then gently lift it 
out of the circuit board. As a last resort (or If a desoldering station is not 
available), snip every pin of the chips and remove the body. Then desolder 
the pins individually. Do not allow the circuit board to heat up much as this 
might lift some of the fine traces. Also be careful about pulling the plated 
through holes out. After all 16 chips are removed, examine the board for any- 
lifted traces and solder bridges. Remove any solder bridges. For lifted 
traces, note which pads they connect. This will be fixed later. Remrove any 
loose traces that might short other traces. Pay particular notice to the top 
side of the board as this will be inaccessible after the sockets are 
Installed. 

Now install the sockets, if they have any orientation, place the pin one 
end (this generally has a notch) towards the front of the circuit board. The 
sllkscreened pattern on the board should match. As the sockets are 
installed, it may help to bend pins on two opposing corners out slightly to 
hold the socket while the board is turned upside down to tack solder these 
two pins. Now reheat these pins and at the same time push the socket all 
the way against the circuit board. Finally solder the remaininq pins and 
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perhaps add some extra solder to the first tsvo pins. Do not use excessive 
amounts of solder as this will terfd to cause solder bridges. It may also 
cause the solder to flow down through the board and into the socket - 
preventing a pin from being insertable. With all sockets installed, check 
once again for solder bridges and remove any. At this time use the fine wire 
to replace any traces that svere liftsd during the desoldering phase. 

(The following step may be omitted if desired.) Now plug the new 
memory chips into the sockets. Pin 1 on a11 of them is towards the corner 
of the board with the keyboard plug. In other words, the pin I end is 
tosvards the front of the circuit board (which is normally toward the front 
of the co.mputer). It should also line up with the notch d.rawn on the board 
and probably the sockets. Make sure that all pins are seated correctly in the 
sockets and not bent under the chips or perhaps outside the socket. 
Double-check for any scrap solder or solder bridges. Now place the board 
back into the chassis and reconnect the power and disk cables. Set the 
Macintosh upright and plug me power cable in (without putting the cover on). 
Be careful not to touch any of tne inside circuitry while the power is on. 
Turn the system on and venfy that it operates (still at 128K though). Once 
operation has been verified, turn it off and unplug the power cable. Wait 
several minutes and then remove the logic board again. Be careful around 
the CRT as it will still contain a high voltage charge. 

The purpose of the preceding step is to verify that the sockets were 
installed correctly and that there are no solder bridges, it also partially 
tests the new memory chips. !f there was a problem, the Macintosh sviil 
place a sad Mac on the screen and show an error code below it. A memory 
error was found if the first two digits of the code are 02 through 05. in 
this case the last four digits are a 16 bit number written in heKadecimal. 
Each suspected memory chip has the bit in it's position set to a 1 in this 
number. Consult the MacPainting Memory to map this value to the actual 
chips involved. (For example, if DO was set in the mask, then consult the 
schematic to find that DO connects to the chip at F5.) If there is a problem, 
check very carefully for shorts and/or breaks in traces. Perhaps use an 
ohmrneter to verify the board against the schematics included elsewhere in 
this disk. 

The next step is adding the extra multiplexer chip. This can precede in 
one of several ways. The newer circuit boards have a place for the 
multiplexer. The older (original) boards only have a row of pads which can 
be used to tap into the needed signals. With these boards, the extra chip can 
be either piggy-back onto an existing one or mounted on a custom printed 
circuit board that attaches to the row of pads. 
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• For the newer circuit boards: 

There is on unused location ot G13 (very near the keyboard connector). 
This is designed to hold the extra 74AS253 chip needed. Sirnply mount a 
socket there and then plug the chip in (it has the same pin I orientation as 
the memory). Also, add the two 2.2KQ and the 47Q resistors as shown in 
the schematics. These go in the locations marked R40, R4I, and R42. Add 
the .luF capacitor at the location marked C51. Finally, cut the jumper 
marked as W1 and labeled 128K only. 

Nov/ reassemble the computer and precede with testing as above. The 
computer should novY operate as a 512K system. If everything works, then 
reattach the case and the various other peripherals. Remember to place the 
foil shield over the connectors. Also, the user preferences selected via the 
control panel will need to be reentered. 

• For older circuit boards that will have the multiplexer piggy-backed: 

•Several pins of the multiplexer will need to be soldered to the chip 
directly below it. These are: 2, 8, 14, and 16. Bend all other pins straight 
out so that they can be connected separately. Mow place this multiplexer 
directly on top of the one at F3. (it could also be placed on top of F4, G3, or 
64 but F3 is closest to the row of 7 pads with the needed extra signals. 
Also, it might be desirable to place the two chip assembly in a socket.) Now 
wire up pins I and 3 through 7 to mimic the circuitry on Apple's newer logic 
boards. Don't forget to add the 47Q and 2.2KQ resistors. The signals A 17, 
A 16, and RA8 are available at various positions in the row of 7 pads near 
the end of the 613000 CPU. Finally, cut the trace on the bottom side of the 
board that connects pins 1 and 2 of the pads. Now precede with system 
check out as above. 

• For older circuit boards that will have an extra board added: 

Make a printed circuit board that provides all the needed connections. If 
a 74AS253 (or 74F253) device is not available, this method can allovY the 
use of other similar multiplexers. Continue by attaching the board to the 
pads. Cut the trace connecting pins 1 and 2 there and precede with system 
check out as above. 

Note that adding the extra board allows for some interesting changes to 
be made. Read the next page of the document for more data. 
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Upgrade info 

The multiplexer added during the upgrsde functions to send the A 17 and 
A 18 address iines from the CPU to the memory chips. For video and sound 
hardware memory references, the multiplexer output should be at the level 
it is when both A 17 and A18 are high. For a non-inverting multiplexer, this 
is a high logic level. It is a "low" for inverting multipleKers. Note that at 
no time should the multiple>^er tn-state it's output. The only reason that 
the multiplexers driving RAO through RA7 tri-stats is that they need to 
multiplex a total of 6 signals onto each memory row address. 

The 47Q resistor on the output is needed to reduce rinqing caused by the 
highly capacitive load that the memory chips create. Without it, the 
effective access time wiU increase. EMi/RFi emissions might also increase. 
The two pull up resistors on the address lines are there to keep them at a 
known state wnen the 68000 is currently in an inactive bus cycle. This can 
be important for the row address as the hards-vare will still cycle the 
memory even during idle time intervals. 

The 74ASXXX parts are not used primarily for their speed, but rather for 
their reduced input currents. (V/itness the 74LS257 parts used to multiplex 
the sound address.) 74LS253 parts would have been too slow svhile 74S253 
parts would have required too large of an input current on several of the 
address lines. The AS parts are thus a useful compromise. 

All the multiplexers available are not used to their fullest when 
emulating Apple's circuitry. Most have at least half unused. By choosing the 
correct part, this extra capability can be used to create a system that can 
be both a 128K and a 512K computer. This can be useful to a software 
developer who needs 512K to develop a program but would like to test it in a 
128K environment. Consult the MacPaint document 128K/512K for the 
schematic of such a modification. !n this circuit, the D flip-flop is used to 
select between the two memory sizes. It latches the state of the interrupt 
button at the end of each system reset. Simply pressing this button during a 
reset is enough to select 128K. Note however that the reset signal has a 
very long debounce time interval (more than 1 second). To connect this 
circuit, interrupt and reset are tapped by soldering a wire to one end of the 
pullup resistors for these signals. A 74S151 part could be used since A 17 
and A 18 did not connect to any other loads in the computer. 
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Beyond 512K 

This document does not contain any specific information about the 
lacintosh. Instead, it contains several raw ideas for eKpanding memory 
beyond the standard limit of 512K. There are several software problems 
with this. The first is that the ROM (and some other code) checks for how 
much memory is available and chooses either I28K or 512K. Other sizes 
will not be recognized without operating system patches. The second 
problem is that during system boot, the ROM addresses video memory at the 
locations where it is found in a 512K system, in a 1 megabyte system, this 
would require that the video memory be placed in the middle of the memory 
address space. This will interfere with a linear growth of memory heaps. 
There are two solutions. The first is to use the extra 512K as a RAM disk. 
The second is to patch the InitApplZone system trap to allocate the video 
memory as a non-relocatable block inside the application heap. (Of course 
this problem can be easily fixed by a ROM change.) The final problem with 
large memory spaces is that the BlockMove system trap can only correctly 
move a maximum of 3 megabytes at a time. 

The memory expansion described here would be performed by soldering a 
second 512K of memory on top of the present memory chips and generating a 
separate RAS (and possible CAS) for this new bank. To avoid a doubling in 
power dissipation, only one bank would be given RAS at a time. Because of 
the characteristics of dynamic memory, the power dissipation of IM of 
memory connected this way svould be only slightly higher than that of the 
standard 512K. Memory refresh is the biggest concern in such a design. The 
most critical point is during vertical retrace as video reads do not happen in 
this time interval. Below is a summary of the refresh intervals with 
various memory bank interleaving schemes. 

Some system constants: 

» 44 word times per scan line 

9 370 scan lines per frame 

• 28 inactive scan lines per frame 

9 32*342 screen memory reads per frame 

All numbers below are either scan line indexes or time intervals in scan 
lines. The values in parentheses specify a range of video scan lines (which 
are not necessarily active lines) In the format: (startline ... endline). 
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If alternate words are located in alternating banks, the inactive time in 
scan lines is: 

(A1 selects which bank to use.) 

(for 256 row refresh cnips)(16 scan lines for all rows) 
(336 ... 341) to (0 ... 5) = 6 + 28 = 34 scan lines 
(326 ... 335) to (6 ... 15) = 6 + 28 + 16 = 50 scan lines 

(for 128 row refresh chips)(8 scan lines for all rows) 
(336 ... 341) to (0 ... 5) = 5 + 23 scan lines = 34 scan lines 
(334 ... 335) to (6 ... 7) = b + 23 ■«■ 6 = 42 scan lines 

if 256 words are found in one bank with the following 256 words m the 
other bank, the inactive time m scan lines is; 
(A9 selects which bank to use.) 

(for 256 row refresh chips)(]6 scan lines for ail rows) 
(8 scan lines from one bank, then 8 from the other bank) 
(326 ... 335) to (6 ... 15) = 6 + 16 + 28 = 50 scan lines 
(336 ... 341) to (0 ... 5) =6 + 28 - 34 scan lines 

If 128 words are found in one bank with the following 128 words in the 
other bank, the inactive time in scan lines is: 
(A8 selects which bank to use.) 

(for 128 row refresh chips)(8 scan lines for all rows) 
(4 scan lines from one bank, then 4 from the other bank) 
(336 ... 341) to (0 ... 5) = 6 + 28 scan lines = 24 scan lines 
(334 ... 335) to (6 ... 7) = 6 + 26 + 8 = 42 scan lines 

The conversion from scan line times to actual time is: 

34 scan lines = 1.528 ms 
42 scan lines = 1.887 ms 
50 scan lines = 2.247 ms 
44.5 scan lines = 2.000 ms 



mils in iS(S®?|p2MlSi(S 

© 1 985 



From the above it can be seen that if banks Qre switched by At, refresh 
timing will be met for both 126 (2 rnS) and 256 (4 mS) row refresh chips, if 
larger number of contiguous words reside in the some bonk, then the 
actual arrangement needed depends on the chips used. (Note that the above 
assumes that the low order address bits are given to the memory chips as a 
row address (as they are in the Mac).) In practice it might be preferable to 
place a larger number of words in the same bank. This so that the minimum 
number of multiplexer inputs need to be rerouted. 

One final item needs mentioning. The system can be speeded up 
somewhat by changing the memory timing slightly. Since this involves 
changes to the same PALs as with the extra memory, it might be reasonable 
to perform both changes at once. The present timing performs two memory 
cycles in every "luS interval. This could be increased to 4 cycles; 2 for the 
CPU, one for video, and one idle. (During video retrace, it's cycle would also 
be idle - i.e., the memory would not receive any control signals.) if this is 
done, the cycles will be around 255 nS long. This requires some fast 
memory chips that will be run at their limits. 
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